List phone numbers

This endpoint has a side effect. When called, if there is no primary phone number associated with the customer, it will use the phone number in the customer entry to create the primary phone number.

get

Retrieve all phone numbers associated with a specific customer.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

customerIdstringRequired

Responses

200

Successful Response

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/v1/agents/{agentId}/customers/{customerId}/phone-numbers

HTTPcURLJavaScriptPython

GET /v1/agents/{agentId}/customers/{customerId}/phone-numbers HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "id": "text",
      "phoneNumber": "text",
      "type": "primary",
      "phoneType": "text",
      "lineType": "landline",
      "lineStatus": "active",
      "verified": true,
      "note": "text",
      "conversationSid": "text",
      "createdAt": "2026-01-31T08:15:08.860Z",
      "updatedAt": "2026-01-31T08:15:08.860Z"
    }
  ]
}