Pagination and errors
How list endpoints page through results, and every error code the API returns.
List endpoints return one page at a time and say whether there's more. Errors share one envelope,
with a code your code can branch on.
Pagination
| Endpoint | Parameters | Tells you there's more |
|---|---|---|
GET /decisions, GET /action-items | limit (1 to 100, default 25), offset (up to 1,000) | hasMore |
GET /search | limit (1 to 100, default 20), offset (up to 118) | hasMore |
GET /groups | limit (1 to 100), offset, both optional | hasMore, only when you pass limit or offset |
GET /meetings | page (from 1), limit (1 to 100, default 20) | hasMore and totalCount |
GET /meetings/{id}/transcript | startSeconds (default 0) | nextStartSeconds, null at the end |
To read the next page, add limit to offset (or add 1 to page) and call again until hasMore
is false. For a transcript, pass nextStartSeconds back as startSeconds until it's null.
GET /decisions and GET /action-items don't page past an offset of 1,000. To reach older
items, narrow the request with since or meetingId instead. GET /action-items also answers
truncated: true when it stopped before reading every meeting; narrow the same way to see the rest.
Errors
Every error has the same shape:
{ "success": false, "error": { "type": "error", "code": "not_found", "message": "Meeting not found" } }
A parameter or body that fails validation is a 400 with type set to validation and the
messages per field:
{ "success": false, "error": { "type": "validation", "errors": { "limit": ["…"] } } }
| Status | code | Meaning |
|---|---|---|
| 400 | (validation) | A parameter or the body is invalid. errors lists each field. |
| 401 | invalid_api_key | The key is wrong, revoked or no longer valid. See Authentication. |
| 401 | unauthorized | No Authorization header, or a bearer token that isn't an API key. |
| 403 | api_keys_disabled | API keys are turned off for your organization. |
| 403 | api_key_not_allowed | The endpoint doesn't take API keys. |
| 403 | api_key_required | The endpoint takes only an API key (the /hooks endpoints). |
| 403 | email_not_verified, org_suspended | Your account or organization can't use the API right now. |
| 403 | unauthorized | You can open the meeting but not do this with it, such as exporting a meeting shared with you for viewing only. |
| 404 | not_found, access_denied | It doesn't exist, or the key owner can't open it. The two look the same on purpose. |
| 404 | no_transcript | The meeting has no transcript: its transcript sections, or an srt export. |
| 409 | subscription_stopped | This automation was stopped in VoiceCap and can't be switched back on from here. |
| 422 | unknown_event | No event has that name. |
| 422 | invalid_target_url | The webhook URL isn't a public https URL. The message says what's wrong. |
| 422 | callback_verification_failed | Your endpoint didn't answer the test request. |
| 422 | subscription_limit | A webhook subscription limit was reached. Remove a subscription you no longer use. |
| 429 | rate_limited | Too many requests. See Rate limits. |
A 422 with type set to validation means a webhook filter is invalid. Its errors keys start
with filters., such as filters.groupId.