Skip to main content
GET
/
v1
/
calls
List calls
curl --request GET \
  --url https://api.example.com/v1/calls \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "callType": "CALL_SESSION",
      "status": "completed",
      "type": "outbound",
      "startedAt": "2024-03-20T09:00:00.000Z",
      "endedAt": "2024-03-20T09:15:00.000Z",
      "createdAt": "2024-03-20T08:55:00.000Z",
      "contact": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "firstName": "John",
        "lastName": "Doe",
        "isUnknown": false
      },
      "phoneNumber": {
        "value": "+33612345678"
      },
      "caller": {
        "firstName": "Alice",
        "lastName": "Martin"
      },
      "callerPhoneNumber": {
        "value": "+33612345678"
      },
      "phoneNumberId": "123e4567-e89b-12d3-a456-426614174002",
      "userProviderSid": "CA123456789",
      "adminProviderSid": "CA987654321",
      "providerConferenceId": "CF123456789",
      "transferred": false,
      "updatedAt": "2024-03-20T09:16:00.000Z",
      "sequenceRunId": "123e4567-e89b-12d3-a456-426614174003",
      "sequenceId": "123e4567-e89b-12d3-a456-426614174010",
      "syncedWithCrmDate": "2024-03-20T09:15:00.000Z",
      "deletedAt": "2024-03-20T09:15:00.000Z",
      "organizationId": "123e4567-e89b-12d3-a456-426614174004",
      "organizationMembershipId": "123e4567-e89b-12d3-a456-426614174005",
      "managedPhoneNumberId": "123e4567-e89b-12d3-a456-426614174006",
      "notes": "Call notes here"
    }
  ],
  "total": 100,
  "page": 1,
  "limit": 10,
  "totalPages": 10
}

Authorizations

Authorization
string
header
required

Enter your API Key (sk_live_xxx or sk_test_xxx)

Query Parameters

page
number
default:1

Page number (starts at 1)

Example:

1

limit
number
default:10

Number of items per page

Example:

10

sort
object
filters
string

Filters as JSON string

Response

Paginated list of calls

data
object[]
required
total
number
required
Example:

100

page
number
required
Example:

1

limit
number
required
Example:

10

totalPages
number
required
Example:

10