List recordings

GET

https://{your_space_name}.signalwire.com/api/relay/rest/recordings

GET

/api/relay/rest/recordings

$ curl https://{your_space_name}.signalwire.com/api/relay/rest/recordings \
>      -u "<project_id>:<api_token>"

1 {
2   "links": {
3     "self": "string",
4     "first": "string",
5     "next": "string",
6     "prev": "string"
7   },
8   "data": [
9     {
10       "byte_size": 10,
11       "created_at": "2024-01-15T09:30:00Z",
12       "duration_in_seconds": 2,
13       "error_code": "string",
14       "id": "d369a402-7b43-4512-8735-9d5e1f387814",
15       "price": 0.05,
16       "price_unit": "USD",
17       "project_id": "d369a402-7b43-4512-8735-9d5e1f387814",
18       "relay_conference_id": "0089cc48-4f98-4a6b-90d8-61f8a5d1b0e3",
19       "relay_pstn_leg_id": "string",
20       "status": "completed",
21       "stereo": false,
22       "track": "inbound",
23       "updated_at": "2024-01-15T09:30:00Z",
24       "url": "https://example.com/recording.mp3"
25     }
26   ]
27 }

Returns the project’s voice call recordings for later review or cleanup. Use it to browse recordings across calls; use Get recording when you already have the recording ID. Compatibility Recordings include per-call creation and management, while Room Recordings contain video-room media.

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.

Returns the project's voice call recordings for later review or cleanup. Use it to browse recordings across calls; use [Get recording](/docs/apis/rest/recordings/get-call-recording) when you already have the recording ID. Compatibility [Recordings](/docs/compatibility-api/rest/recordings/list-recordings) include per-call creation and management, while [Room Recordings](/docs/apis/rest/video/room-recordings/list-room-recordings) contain video-room media. #### 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)

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) ```

Response

The request has succeeded.

linksobject

Pagination links.

datalist of objects

List of recordings.

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error