Skip to main content
GET
/
v1
/
calls
/
{callId}
/
recordings
cURL
curl --request GET \
  --url https://api.buildwithchirp.com/v1/calls/{callId}/recordings \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "call_rec_2DbBs7GWhGvVNJGrDXr5RG0mBWI",
      "callId": "call_2DbBs7GWhGvVNJGrDXr5RG0mBWI",
      "status": "completed",
      "format": "mp4",
      "duration": 120,
      "fileUrl": "<string>",
      "fileSize": 123,
      "startedAt": "2023-11-07T05:31:56Z",
      "endedAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ],
  "totalCount": 123
}

Authorizations

​
Authorization
string
header
required

App API key (format: sk_live_app_* or sk_test_app_*) for app-level operations

Path Parameters

​
callId
string
required

Unique identifier for a Call. Format: call_[test_]{ksuid}

Pattern: ^call_(?:test_)?[a-zA-Z0-9]{27}$
Example:

"call_2DbBs7GWhGvVNJGrDXr5RG0mBWI"

Response

List of recordings

​
data
object[]
required
​
totalCount
number
required