# ZenSched Event List

> ZenSched Event List is a paid API for AI agents from mcp.zensched.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

Lists scheduled events for an organization with optional filters by location, brand, and date range, returning paginated results.

## Facts

- Endpoint: GET https://mcp.zensched.com/x402/tools/event_list?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zensched-event-list-0b4cccc3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__uzlmHxSzGZNHt-YmV7Hu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zensched-event-list-0b4cccc3
```

Example prompt: Pull up all our scheduled events for location 12 between January 1st and March 31st — show me the first 100 and let me know if there are more.

## When to prefer this

Use this endpoint when you need to retrieve a list of scheduled events for an organization, optionally scoped to a specific location, brand, or date window. It is the primary read endpoint for event discovery and calendar views within ZenSched. Prefer it over webhook-based approaches when you need an on-demand snapshot rather than real-time push notifications.

## Known failure modes

- Invalid date format (must be YYYY-MM-DD) returns a validation error
- Non-existent location_id or brand_id returns an empty result or 404
- Limit exceeding 500 may be rejected or capped
- Payment failure (insufficient USDC balance) blocks the call
- Unauthenticated or unauthorized wallet returns a 402 or 401 error
- offset beyond total count returns empty events list with has_more false

## How this service works

ZenSched `event_list` — List events with optional filters: location_id, brand_id, date_from/date_to (YYYY-MM-DD), limit (max 500), offset. Returns total and has_more. Pay-per-call $0.01 USDC; the paying wallet owns the org (auto-provisioned on first call). Catalog: https://mcp.zensched.com/x402/tools

## Output

Returns a paginated JSON object containing a list of events matching the filters, along with a total count and a has_more boolean indicating whether additional pages exist beyond the current offset.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "title": "event_listArguments",
     "properties": {
      "limit": {
       "type": "integer",
       "title": "Limit",
       "default": 100
      },
      "offset": {
       "type": "integer",
       "title": "Offset",
       "default": 0
      },
      "date_to": {
       "type": "string",
       "title": "Date To",
       "default": ""
      },
      "brand_id": {
       "type": "integer",
       "title": "Brand Id",
       "default": -1
      },
      "date_from": {
       "type": "string",
       "title": "Date From",
       "default": ""
      },
      "location_id": {
       "type": "integer",
       "title": "Location Id",
       "default": 0
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zensched-event-list-0b4cccc3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.zensched.com](https://www.zero.xyz/host/mcp.zensched.com/llms.txt)