v53

latestOpenAPI 3.1.1raw.githubusercontent.com2026-07-264065213.4 KB

Phone numbers

Retrieve a phone number

Retrieves a PhoneNumber object.

get/phone_numbers/{id}

Path parameters

idstring required

The ID of the phone number to retrieve.

Example:pn_01jsjwe4d9fx3tpymgtg958d9w

Response

Phone number

campaign_idstring nullable required

Deprecated. The unique identifier of the campaign this phone number is attached to, if any

idstring required

Unique identifier for the phone number

namestring nullable required

A human-readable name for the phone number

numberstring phone-number required

The phone number in E.164 format

type'local' | 'short_code' | 'toll_free' required

Whether the phone number is local, toll-free, or short code

Example response

{
  "campaign": {
    "attachment_status": "attached",
    "id": "cpn_01jjnn7s0zfx5tdcsxjfy93et2"
  },
  "campaign_id": "cpn_01jjnn7s0zfx5tdcsxjfy93et2",
  "id": "pn_01jsjwe4d9fx3tpymgtg958d9w",
  "name": "(801) 555-1234",
  "number": "+18015551234",
  "type": "local"
}