Skip to main content
GET
/
v1
/
api
/
call-dispositions
List Call Dispositions
curl --request GET \
  --url https://api.trillet.ai/v1/api/call-dispositions \
  --header 'x-api-key: <api-key>' \
  --header 'x-workspace-id: <x-workspace-id>'
{
  "data": {
    "dispositions": [
      {
        "_id": "665a1b2c3d4e5f6a7b8c9d0e",
        "phoneNumber": "+14155551234",
        "disposition": "callback_scheduled",
        "status": "pending",
        "scheduledAt": "2024-06-02T14:00:00.000Z",
        "attempt": 1,
        "agentId": "665a1b2c3d4e5f6a7b8c9d0f",
        "batchId": "665a1b2c3d4e5f6a7b8c9d10",
        "createdAt": "2024-06-01T10:00:00.000Z"
      }
    ],
    "total": 25,
    "page": 1,
    "limit": 50,
    "totalPages": 1
  }
}

​
Headers

​
x-api-key
string
required
API key used for authenticating requests to the API.
​
x-workspace-id
string
required
Workspace identifier for the API.

​
Query Parameters

​
page
number
default:"1"
Page number for pagination.
​
limit
number
default:"50"
Number of records per page.
​
phoneNumber
string
Filter by phone number.
​
batchId
string
Filter by batch call ID.
​
agentId
string
Filter by agent ID.
​
status
string
Filter by disposition status.
​
disposition
string
Filter by disposition type.
​
attempt
number
Filter by attempt number.
​
search
string
Search across dispositions.
​
timezone
string
Timezone for date formatting (e.g., “America/New_York”).

​
Response Fields

​
data
object
Paginated disposition data.
​
dispositions
array
Array of call disposition objects.
​
total
number
Total number of matching dispositions.
​
page
number
Current page number.
​
limit
number
Records per page.
​
totalPages
number
Total number of pages.
{
  "data": {
    "dispositions": [
      {
        "_id": "665a1b2c3d4e5f6a7b8c9d0e",
        "phoneNumber": "+14155551234",
        "disposition": "callback_scheduled",
        "status": "pending",
        "scheduledAt": "2024-06-02T14:00:00.000Z",
        "attempt": 1,
        "agentId": "665a1b2c3d4e5f6a7b8c9d0f",
        "batchId": "665a1b2c3d4e5f6a7b8c9d10",
        "createdAt": "2024-06-01T10:00:00.000Z"
      }
    ],
    "total": 25,
    "page": 1,
    "limit": 50,
    "totalPages": 1
  }
}