Skip to main content
GET
List Requests

Authorizations

Authorization
string
header
required

Bearer token obtained from the /v1/auth endpoint

Query Parameters

dateFrom
string<date>

Optional. Start of the dateCreated window (inclusive), YYYY-MM-DD. Interpreted as UTC midnight. When omitted (and requestBatchId is also omitted), defaults to today in the server's clock.

dateTo
string<date>

Optional. End of the dateCreated window (exclusive), YYYY-MM-DD. Interpreted as UTC midnight. When omitted (and requestBatchId is also omitted), defaults to tomorrow in the server's clock.

requestBatchId
string

Optional. Return every request belonging to this requestBatchId. Bypasses the dateFrom/dateTo defaults. Passing this returns matching requests regardless of when they were created.

pageSize
integer

Optional. Turns on pagination. Maximum number of requests to return in one page (1 to 500). Omit to return every matching request in one response. A value outside the range is rejected with 400 INVALID_REQUEST.

Required range: 1 <= x <= 500
pageToken
string

Optional. Opaque cursor from a previous response's nextPageToken. Resumes the listing where the previous page ended. Keep the other filters unchanged across pages. Passing pageToken without pageSize applies the default page size of 100. A malformed token is rejected with 400 INVALID_REQUEST.

Response

List of requests. The list endpoint omits transcript and recordingDownloadUrl. Fetch GET /v1/requests/{requestId} for those. Every other field on RequestResponse (including state, modality, data_completeness, error) is included when applicable.

requests
object[]
nextPageToken
string

Present only when more pages remain, which requires pageSize (or pageToken) on the request. Pass it back as pageToken to fetch the next page. Absent on the final page.