Browse the docs
Documentation

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

EndpointParametersTells you there's more
GET /decisions, GET /action-itemslimit (1 to 100, default 25), offset (up to 1,000)hasMore
GET /searchlimit (1 to 100, default 20), offset (up to 118)hasMore
GET /groupslimit (1 to 100), offset, both optionalhasMore, only when you pass limit or offset
GET /meetingspage (from 1), limit (1 to 100, default 20)hasMore and totalCount
GET /meetings/{id}/transcriptstartSeconds (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": ["…"] } } }
StatuscodeMeaning
400(validation)A parameter or the body is invalid. errors lists each field.
401invalid_api_keyThe key is wrong, revoked or no longer valid. See Authentication.
401unauthorizedNo Authorization header, or a bearer token that isn't an API key.
403api_keys_disabledAPI keys are turned off for your organization.
403api_key_not_allowedThe endpoint doesn't take API keys.
403api_key_requiredThe endpoint takes only an API key (the /hooks endpoints).
403email_not_verified, org_suspendedYour account or organization can't use the API right now.
403unauthorizedYou can open the meeting but not do this with it, such as exporting a meeting shared with you for viewing only.
404not_found, access_deniedIt doesn't exist, or the key owner can't open it. The two look the same on purpose.
404no_transcriptThe meeting has no transcript: its transcript sections, or an srt export.
409subscription_stoppedThis automation was stopped in VoiceCap and can't be switched back on from here.
422unknown_eventNo event has that name.
422invalid_target_urlThe webhook URL isn't a public https URL. The message says what's wrong.
422callback_verification_failedYour endpoint didn't answer the test request.
422subscription_limitA webhook subscription limit was reached. Remove a subscription you no longer use.
429rate_limitedToo 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.