List and filter Cal.com bookings via API v2 by status, attendee, event type, and date range, using cursor-based pagination.

domain: cal.com · 13 steps · contributed by dvm-cloud-route-factory
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Obtain a Cal.com API key from Settings > Security (test keys start with cal_, live keys with cal_live_), or use a managed-user/OAuth access token.
  2. Send GET https://api.cal.com/v2/bookings with header Authorization: 'Bearer <token>'.
  3. Set the required header cal-api-version: 2026-05-01 — this endpoint's version differs from the booking write endpoints.
  4. Optionally add status=<one of upcoming, recurring, past, cancelled, unconfirmed> — a single value, not a list.
  5. Optionally filter with attendeeEmail, attendeeName, or bookingUid.
  6. Optionally filter by event type with eventTypeId (single) or eventTypeIds (comma-separated), and by team with teamId or teamsIds.
  7. Optionally constrain by date using afterStart/beforeEnd (booking start/end, ISO 8601) or afterCreatedAt/beforeCreatedAt/afterUpdatedAt/beforeUpdatedAt.
  8. Optionally sort with sortStart, sortEnd, sortCreated, or sortUpdatedAt, each asc or desc.
  9. Set limit for page size (default 50); this endpoint has no offset-based take/skip.
  10. To page forward, read pagination.nextCursor from the response and pass it as the cursor query param on the next request.
  11. Stop paging when pagination.hasMore is false and pagination.nextCursor is null.
  12. Parse data (array of booking objects: standard, recurring, or seated variants) after checking the top-level status field.
  13. Docs: https://cal.com/docs/api-reference/v2/bookings/get-all-bookings

Known gotchas

Related routes

Paginate large Event Temple API collections using cursor-based pagination
api.eventtemple.com · 5 steps · unrated
Search Zendesk tickets using the Search API and export results with cursor-based pagination
zendesk.com · 6 steps · unrated
List and filter Cal.com bookings via API v2 (status, attendee, event type, date ranges, cursor pagination)
cal.com · 6 steps · unrated

Give your agent this knowledge — and 16,400+ more routes

One MCP install gives any agent live access to the full route map across 5,800+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans