Skip to main content
GET

List Phone Numbers

Retrieve a list of available phone numbers with various filtering options. This endpoint returns phone numbers with their capabilities, pricing, and status information.

Endpoint

Request headers

string
required
Bearer token for authentication. Format: Bearer talq_your_environment_token_here

Query parameters

string
Filter by phone number type. Options: voice, sms, whatsapp, mms, fax
boolean
Filter by voice capability. Options: true, false
boolean
Filter by WhatsApp capability. Options: true, false
Search by phone number or ID

Example requests

Response

Success Response (200 OK)

Response fields

boolean
required
Indicates if the operation was successful.
array
required
Array of phone number objects.

Error responses

401 Unauthorized

422 Validation Error

500 Server Error

Error codes

Important notes

Filtering capabilities. Use query parameters to filter phone numbers by type, and capabilities.
Pricing information. Each phone number includes current pricing and renewal information.
Status tracking. Monitor phone number status and renewal dates to avoid service interruptions.
  • List Voice Templates: GET /api/v1/voice-templates
  • Generate Voice Template Demo: GET /api/v1/voice-templates/{voiceTemplate}/demo