List meetings
Returns your booked, completed and cancelled meetings, newest booking first. fromDate and toDate filter on updatedAt. Meetings booked by your own team members are not listed.
ApiKeyAuthx-api-key<token>Your Knock API key. Ask your Knock account team for one: a key with the Enrichment API role for enrichment, or the Viewer role for chats and meetings.
limit?integerPage size.
1 <= value <= 10050offset?integerNumber of items to skip.
0 <= value0fromDate?stringStart of the time window, inclusive: a date (YYYY-MM-DD) for the start of that day in UTC, or a date-time (YYYY-MM-DDTHH:mm[:ss[.sss]], optionally followed by Z or ±HH:MM; UTC without one).
^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:\d{2})?)?$toDate?stringEnd of the time window, inclusive: a date (YYYY-MM-DD) for the end of that day in UTC, or a date-time (YYYY-MM-DDTHH:mm[:ss[.sss]], optionally followed by Z or ±HH:MM; UTC without one).
^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:\d{2})?)?$A page of meetings.
application/json- response
A page of meetings.
total*integerNumber of items that match the query, across all pages.
limit*integerPage size of this page.
offset*integerNumber of items skipped before this page.
items*array<>Meetings, newest booking first.
curl -X GET 'https://app.knock-ai.com/v1/meetings' \ -H 'x-api-key: <YOUR_API_KEY>'{ "total": 1, "limit": 50, "offset": 0, "items": [ { "meetingId": "2e4f6a8c-0b1d-4c3e-9f5a-7b8c9d0e1f2a", "contactId": "9b1e4c2a-6f3d-4e8b-a7c5-1d2e3f4a5b6c", "status": "booked", "bookingSource": "meeting_link", "bookedAt": "2026-10-18T12:00:00.000Z", "startAt": "2026-10-25T15:00:00.000Z", "endAt": "2026-10-25T15:30:00.000Z", "updatedAt": "2026-10-18T12:00:00.000Z", "firstName": "Jane", "lastName": "Doe", "companyName": "Acme", "companyDomain": "acme.com", "segment": "Enterprise", "ownerId": "5a7c9e1b-3d5f-4a6b-8c9d-0e1f2a3b4c5d", "ownerName": "Alex Kim" } ]}