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

This an object representing a customer's phone number.

idstringRequired

phoneNumberstringRequired

typestring · enumRequiredPossible values:

phoneTypestringRequired

lineTypestring · enumOptionalPossible values:

lineStatusstring · enumOptionalPossible values:

verifiedbooleanOptional

notestringOptional

conversationSidstringOptional

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

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": "2026-04-02T10:33:59.704Z",
  "updatedAt": "2026-04-02T10:33:59.704Z"
}