Skip to main content
GET
/
v1
/
recordings
List Recordings
curl --request GET \
  --url https://api.example.com/v1/recordings
{
  "data": [
    {
      "id": "<string>",
      "toNumber": "<string>",
      "fromNumber": "<string>",
      "duration": 123,
      "status": "<string>",
      "direction": "<string>",
      "createdAt": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "totalPages": 123,
    "hasMore": true
  }
}
Returns a paginated list of your recordings, sorted by creation date (newest first).

​
Query Parameters

​
page
integer
default:"1"
Page number (1-indexed)
​
limit
integer
default:"20"
Results per page (max 100)
​
status
string
Filter by status: completed, transcribing, processing, failed
​
direction
string
Filter by call direction: outbound or inbound
​
search
string
Search transcript text

​
Request

curl -X GET "https://app.transcord.app/api/v1/recordings?limit=10" \
  -H "Authorization: Bearer tr_live_your_api_key"

​
Response

​
data
array
Array of recording objects
​
pagination
object
Response
{
  "data": [
    {
      "id": "clx1234567890",
      "toNumber": "+14155551234",
      "fromNumber": "+14155555678",
      "duration": 342,
      "status": "completed",
      "direction": "outbound",
      "createdAt": "2026-01-15T10:30:00.000Z"
    },
    {
      "id": "clx0987654321",
      "toNumber": "+12125559999",
      "fromNumber": "+14155555678",
      "duration": 128,
      "status": "completed",
      "direction": "outbound",
      "createdAt": "2026-01-14T15:45:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 47,
    "totalPages": 5,
    "hasMore": true
  }
}

​
Errors

StatusDescription
400Invalid query parameters
401Invalid or missing API key