Get a phone number

get

Retrieve a specific phone number for a customer.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

customerIdstringRequired

phoneNumberIdstringRequired

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/{phoneNumberId}

HTTPcURLJavaScriptPython

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

{
  "id": "text",
  "phoneNumber": "text",
  "type": "primary",
  "phoneType": "text",
  "lineType": "landline",
  "lineStatus": "active",
  "verified": true,
  "note": "text",
  "conversationSid": "text",
  "createdAt": "2025-12-11T11:43:53.370Z",
  "updatedAt": "2025-12-11T11:43:53.370Z"
}