TwilioCountry Details
Contents
Mobile_API »Get Twilio Countries
Base URL
https://apimobile.callproof.com
Endpoint
/api/twilio-country
Purpose
Retrieves the list of active Twilio countries available for international phone numbering. Countries marked deleted are excluded, the US ISO code is excluded, and USA is sorted first, followed by other countries alphabetically by name.
HTTP Method
GET
Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer access token |
Security
- Yes – Requires Bearer Token authentication.
Parameters
Path Parameters
None.
Query Parameters
None.
Request Body
None.
Successful Response (200)
Returns the Twilio country list.
| Field | Type | Description |
|---|---|---|
| clientStatusCode | integer | Status indicator for the client (for example, 200) |
| user_id | integer | Identifier of the authenticated user |
| company_id | integer | Identifier of the authenticated user’s company |
| data | object | Country list payload |
| uri | string | Requested resource URI |
data.twilio_country[]
| Field | Type | Description |
|---|---|---|
| id | integer | Unique identifier of the country record |
| name | string | Country display name |
| code | string/integer | Dialing / country code |
| iso_code | string | ISO country code (for example, USA)
|
| priority | integer | Sort helper used by the API (0 for USA, otherwise 1)
|
Error Responses
| Status Code | Meaning |
|---|---|
| 400 | Bad Request – Twilio countries could not be retrieved |
| 401 | Unauthorized – missing, invalid, or expired Bearer token |
- 400 – An error occurred while listing countries (for example, "Error while listing Twilio Countries").
- 401 – Authentication failed or the access token is missing/expired.
