Skip to main content
GET
/
phone-numbers
List Phone Numbers
curl --request GET \
  --url https://api.politicalcomms.com/v1/phone-numbers \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": [
    {
      "id": "pn_abc123",
      "number": "+12025551234",
      "channel": "10dlc",
      "owner_type": "campaign",
      "campaign_id": "camp_xyz789",
      "campaign_name": "Fall 2025 GOTV",
      "brand_id": "brand_abc123",
      "brand_name": "Smith PAC",
      "toll_free_verification_id": null,
      "tf_verification_status": null,
      "toll_free_registration_name": null,
      "org_id": "org_123",
      "org_name": "Smith Campaign 2024",
      "status": "active",
      "created_at": "2024-03-01T08:00:00Z"
    },
    {
      "id": "pn_def456",
      "number": "+18005551234",
      "channel": "toll-free",
      "owner_type": "toll_free_registration",
      "campaign_id": null,
      "campaign_name": null,
      "brand_id": null,
      "brand_name": null,
      "toll_free_verification_id": "tfv_abc123",
      "tf_verification_status": "verified",
      "toll_free_registration_name": "Smith Campaign TFN",
      "org_id": "org_123",
      "org_name": "Smith Campaign 2024",
      "status": "active",
      "created_at": "2024-03-02T08:00:00Z"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

Authenticate every request by passing your API key in the X-API-Key header. Keys are scoped to your organization hierarchy.

Query Parameters

​
organization_id
string

Filter to a specific descendant organization

​
brand_id
string

Filter to a specific brand

​
campaign_id
string

Filter to a specific campaign

​
channel
enum<string>

Filter by messaging channel

Available options:
10dlc,
toll-free,
short-code,
rcs
​
owner_type
enum<string>

Filter by what the number belongs to: a 10DLC campaign, a toll-free verification, or neither (purchased but not yet attached)

Available options:
campaign,
toll_free_registration,
unassigned

Response

Successful response