Filter Call History
POST/v1/open-api/call-history/filter
Return a paginated list of call records matching the given filters. All filter fields are optional — omitting a field means "no restriction on that dimension".
Requires grant PERMISSION_OPEN_API_CALL:READ.
Request
Responses
- 200
- 400
- 401
- 403
- 429
Page of call history records.
Validation error (400). Field-level failures are listed in errors[] and error is
null; a malformed / unparsable JSON body is the inverse — error.messageCode is
3705 and errors[] is empty.
Invalid, revoked or expired token (401) — also returned when the connection was
revoked or the company is blocked.
Produced by the authentication filter, so the body is a reduced envelope: no
error, no requestId, and errors is null rather than []. Every cause yields the
same fixed English message.
The token lacks the required permission:scope grant (403).
Rate limit of 60 requests/minute exceeded (429). Like 401, this comes from the
authentication filter: reduced envelope, fixed English message, no error object and no
Retry-After header.