Skip to main content
GET
/
v1
/
get-phone-number
/
{phone_number}
curl "https://api.voicy.co/v1/get-phone-number/%2B15551234567" \
  -H "Authorization: Bearer voicy_sk_live_xxx"

{
  "phone_number_id": "550e8400-e29b-41d4-a716-446655440000",
  "phone_number": "+15551234567",
  "phone_number_pretty": "(555) 123-4567",
  "display_name": "Main Support Line",
  "account_id": "550e8400-e29b-41d4-a716-446655440099",
  "account_name": "Acme Corp",
  "agent_id": "550e8400-e29b-41d4-a716-446655440001",
  "agent_name": "Customer Support Agent",
  "agent_version": 3,
  "status": "active",
  "created_at": "2026-01-15T10:30:00Z"
}
Get details for a specific phone number by its E.164 identifier.

​
Path Parameters

​
phone_number
string
required
Phone number in E.164 format, URL-encoded. For example, +15551234567 should be encoded as %2B15551234567.

​
Response

Returns a Phone Number object. 
curl "https://api.voicy.co/v1/get-phone-number/%2B15551234567" \
  -H "Authorization: Bearer voicy_sk_live_xxx"

{
  "phone_number_id": "550e8400-e29b-41d4-a716-446655440000",
  "phone_number": "+15551234567",
  "phone_number_pretty": "(555) 123-4567",
  "display_name": "Main Support Line",
  "account_id": "550e8400-e29b-41d4-a716-446655440099",
  "account_name": "Acme Corp",
  "agent_id": "550e8400-e29b-41d4-a716-446655440001",
  "agent_name": "Customer Support Agent",
  "agent_version": 3,
  "status": "active",
  "created_at": "2026-01-15T10:30:00Z"
}