Addresses3

AI Agents: Custom6

AI Agents: Dialogflow5

AI Chat1

Alias Addresses5

Call Flows8

Caller ID Name3

Calls1

Campaign Registry: Brands4

Campaign Registry: Campaigns4

Campaign Registry: Phone Number Assignments5

Chat Tokens1

Chunks3

Conference Logs1

Conference Rooms6

Conference Tokens3

cXML Applications5

cXML Scripts6

cXML Webhook6

Documents6

Domain Applications1

E911 Addresses7

Fax Logs2

FreeSWITCH Connector6

Imported Phone Numbers1

Message Logs2

Messages2

Multi-Factor Authentication3

Number Group Membership4

Number Groups5

Phone Number Addresses5

Phone Number Lookup1

Phone Numbers6

Phone Routes1

Project Tokens3

Projects6

PubSub Tokens1

Queue Members3

Queues5

Recordings3

Relay Application6

Resources3

Room Recordings4

Room Sessions5

Room Tokens1

Rooms6

Short Codes3

SIP Addresses5

SIP Credentials7

SIP Endpoints (Legacy)5

SIP Gateway6

SIP Profile2

Space4

Space Balance4

Space Billing10

Space Domain Applications5

Space Members8

Streams7

Subscriber SIP Credentials5

Subscriber Tokens5

Subscribers6

SWML Scripts6

SWML Webhook6

Verified Caller ID7

Video Conferences5

Video Logs2

Voice Logs3

WhatsApp Businesses1

WhatsApp Numbers2

WhatsApp Routes1

WhatsApp Templates5

Webhooks

AI Webhooks8

Calling Webhooks3

Messaging Webhooks3

Recordings

List recordings

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.

get/api/relay/rest/recordings

Response

The request has succeeded.

Example response

{
  "data": [
    {
      "duration_in_seconds": 2,
      "price": 0.05,
      "price_unit": "USD",
      "status": "finished",
      "url": "/api/relay/rest/recordings/d3444402-7b43-4512-8735-9d5e1f387814",
      "byte_size": 10,
      "track": "inbound"
    }
  ]
}

Changes

Changed in 5 of the 161 revisions of this API.1216

Sep 24, 202664cf005f3c1344See the full diff
- ▲
  response property data/items/anyOf[ConferenceRecording]/error_code list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/anyOf[PstnRecording]/error_code list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/anyOf[SipRecording]/error_code list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/anyOf[WebRtcRecording]/error_code list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
Sep 24, 2026232721dea51644See the full diff
- ▲
  the response property ////// became optional for the status
  response-property-became-optional
- ▲
  the response property ////// became optional for the status
  response-property-became-optional
- ▲
  the response property ////// became optional for the status
  response-property-became-optional
- ▲
  the response property ////// became optional for the status
  response-property-became-optional
- ○
  response property data/items/anyOf[ConferenceRecording]/error_code list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/items/anyOf[PstnRecording]/error_code list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/items/anyOf[SipRecording]/error_code list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
- ○
  response property data/items/anyOf[WebRtcRecording]/error_code list-of-types was narrowed by removing types null from media type application/json of response 200
  response-property-list-of-types-narrowed
Sep 24, 20269f861ec3f79344See the full diff
- ▲
  response property data/items/anyOf[ConferenceRecording]/error_code list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/anyOf[PstnRecording]/error_code list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/anyOf[SipRecording]/error_code list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/anyOf[WebRtcRecording]/error_code list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
- ○
  the response property ////// became required for the status
  response-property-became-required
Jun 17, 2026492e0754dc701See the full diff
- ○
  added to the / response property anyOf list for the response status
  response-property-any-of-added
Jun 17, 202620b0f48e796a3See the full diff
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added

Of the 161 revisions, 3 have a changelog that could not be searched.

Full history