Skip to content

Phone numbers

List phone numbers

GET/v1/phone-numbers

List your phone numbers. Use a number's id as the from_number_id (the caller ID) when initiating a call.

On this page

Headers

AuthorizationstringRequired
ApiKey $ENTROVOX_KEY. Keys are issued per organization.

Query parameters

statusstring or nullOptional
pageinteger, min 1Optional

Default 1

page_sizeinteger, 1–100Optional

Default 25

Returns

200 OKSuccessful Response

dataarray of objectAlways present
metaobjectAlways present

Errors

  • 422VALIDATION_ERROR

    A field is missing or invalid, such as a bad E.164 phone or a missing external_id. param names the field.

    Retrying will fail the same way. Fix the request, or contact us.

Any request can also return AUTHENTICATION_REQUIRED, TOKEN_INVALID, API_KEY_EXPIRED, RATE_LIMIT_EXCEEDED or INTERNAL_ERROR.