Sign in
Reference Data

List standard call reasons

Telnyx maintains a library of pre-vetted call-reason phrases (e.g. "Appointment reminders", "Billing inquiries") that carry through DIR vetting smoothly. You can use any string that fits your use case in DirCreateRequest.call_reasons, but matching one of these reduces the chance the vetting team flags the phrasing for clarification.

get/call_reasons

Query parameters

page[number]integer
Example:1

1-based page number. Out-of-range values return an empty page with correct meta.

page[size]integer
Example:100

Items per page. Default 100 for this endpoint (the call-reason library is small and most callers want the whole list in one call). Maximum 250; values above are clamped to 250.

Response

Paginated list of standard call reasons.

Example response

{
  "data": [
    {
      "id": "d29914a4-3c93-440c-af72-03778f442522",
      "reason": "Account Alert",
      "description": "Alert about account status or changes"
    }
  ],
  "meta": {
    "total_pages": 3,
    "total_results": 42,
    "page_number": 1,
    "page_size": 20
  }
}

Changes

Changed in 1 of the 47 revisions of this API.1