Compatibility REST APIRecordings

List all Recordings

View as MarkdownOpen in Claude
List all recordings. Results are returned as a paginated list ordered by creation date (newest first). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space).

Authentication

AuthorizationBasic
SignalWire Basic Authentication using Project ID and API Token. The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password. Example: ``` Authorization: Basic base64(project_id:token) ```

Path parameters

AccountSidstringRequiredformat: "uuid"
The unique identifier for the account that is associated with this recording.

Query parameters

DateCreatedstringOptional

Filter by recordings created on this exact date (RFC 2822 format).

DateCreated<stringOptional

Filter by recordings created before this date (RFC 2822 format).

DateCreated>stringOptional

Filter by recordings created after this date (RFC 2822 format).

CallSidstringOptionalformat: "uuid"
Filter by recordings associated with a specific call.
ConferenceSidstringOptionalformat: "uuid"
Filter by recordings associated with a specific conference.
PageintegerOptional>=0Defaults to 0

The page number to retrieve (zero-indexed).

PageSizeintegerOptional1-1000Defaults to 50
The number of results per page. Default is 50, maximum is 1000.
PageTokenstringOptional

Token for cursor-based pagination. Required when navigating to pages beyond the first.

Response

The request has succeeded.
uristring
The URI of the current page.
first_page_uristring
The URI of the first page.
next_page_uristring or null
The URI of the next page. Null if there are no more pages.
previous_page_uristring or null
The URI of the previous page. Null if this is the first page.
pageinteger

The current page number (zero-indexed).

page_sizeinteger
The number of items per page.
recordingslist of objects
List of recordings.

Errors

400
Bad Request Error
401
Unauthorized Error
422
Unprocessable Entity Error