List all verified caller IDs on your account, or fetch a single entry by phone number.

List Caller IDs

Two read endpoints: list everything on the account, or fetch one by phone number.

List all

Endpoint

GET https://api.tryvox.io/v1/voice/accounts/{auth_id}/verified-caller-ids

Example request

curl -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  https://api.tryvox.io/v1/voice/accounts/$TRYVOX_AUTH_ID/verified-caller-ids

Response

200 OK — returns an array. Pending and verified entries are both included.

[
  {
    "id": "8f7a4b2e-91c2-4f3d-9a1e-2c4b6d8f0a1c",
    "account_id": "TJab12cd34",
    "phone_number": "+919876543210",
    "alias": "Office line",
    "verification_status": "verified",
    "verified_at": "2026-04-09T10:35:12Z",
    "created_at": "2026-04-09T10:30:00Z"
  },
  {
    "id": "1b2c3d4e-5f60-7180-9a2b-3c4d5e6f7a8b",
    "account_id": "TJab12cd34",
    "phone_number": "+14155551234",
    "alias": "Support hotline",
    "verification_status": "pending",
    "created_at": "2026-04-09T11:02:18Z"
  }
]

If no caller IDs are registered, returns [].

Get one

Endpoint

GET https://api.tryvox.io/v1/voice/accounts/{auth_id}/verified-caller-ids/{phone_number}

{phone_number} is the E.164 form, URL-encoded if needed (+ is safe in path segments but encoders may emit %2B — both work).

Example request

curl -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  https://api.tryvox.io/v1/voice/accounts/$TRYVOX_AUTH_ID/verified-caller-ids/+919876543210

Response

200 OK:

{
  "id": "8f7a4b2e-91c2-4f3d-9a1e-2c4b6d8f0a1c",
  "account_id": "TJab12cd34",
  "phone_number": "+919876543210",
  "alias": "Office line",
  "verification_status": "verified",
  "verified_at": "2026-04-09T10:35:12Z",
  "created_at": "2026-04-09T10:30:00Z"
}

Response fields

id — UUID, stable for the lifetime of the entry.
account_id — the API key Auth ID that owns the entry.
phone_number — E.164 number.
alias — friendly label, may be empty.
verification_status — pending or verified.
verified_at — ISO 8601 timestamp, only present when verification_status is verified.
created_at — ISO 8601 timestamp of the initial Initiate call.

Errors

Status	Code	Reason
401	`INVALID_CREDENTIALS`	Auth ID / Auth Token bad
403	`FORBIDDEN`	Auth ID in URL doesn't match the authenticated key
404	`CALLER_ID_NOT_FOUND`	(single-fetch only) no entry for this `phone_number`

Notes

No pagination. The list endpoint returns every caller ID on the account in one response. If you have hundreds of entries, expect a large payload.
No filtering. All entries are returned regardless of verification_status. Filter client-side if needed.

List Caller IDs

On this page