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