---
title: "List phone number campaigns"
method: GET
path: "/10dlc/phone_number_campaigns"
tags: ["Phone Number Campaigns"]
---

# List phone number campaigns

`GET /10dlc/phone_number_campaigns`

## Query parameters

- `recordsPerPage` integer
- `page` integer
- `filter` object
  - `telnyx_campaign_id` string, uuid — Filter results by the Telnyx Campaign id
  - `telnyx_brand_id` string, uuid — Filter results by the Telnyx Brand id
  - `tcr_campaign_id` string — Filter results by the TCR Campaign id
  - `tcr_brand_id` string — Filter results by the TCR Brand id
- `sort` 'assignmentStatus' | '-assignmentStatus' | 'createdAt' | '-createdAt' | 'phoneNumber' | '-phoneNumber' — Specifies the sort order for results. If not given, results are sorted by created_at in descending order.

## Response `200`

Successful Response

- PhoneNumberCampaignPaginated
  - `records` PhoneNumberCampaign[], required
    - `phoneNumber` string, required
    - `brandId` string — Brand ID. Empty if the number is associated to a shared campaign.
    - `tcrBrandId` string — TCR's alphanumeric ID for the brand.
    - `campaignId` string, required — For shared campaigns, this is the TCR campaign ID, otherwise it is the campaign ID
    - `tcrCampaignId` string — TCR's alphanumeric ID for the campaign.
    - `telnyxCampaignId` string — Campaign ID. Empty if the number is associated to a shared campaign.
    - `assignmentStatus` 'FAILED_ASSIGNMENT' | 'PENDING_ASSIGNMENT' | 'ASSIGNED' | 'PENDING_UNASSIGNMENT' | 'FAILED_UNASSIGNMENT' — The assignment status of the number.
    - `failureReasons` string — Extra info about a failure to assign/unassign a number. Relevant only if the assignmentStatus is either FAILED_ASSIGNMENT or FAILED_UNASSIGNMENT
    - `createdAt` string, required
    - `updatedAt` string, required
  - `page` integer, required
  - `totalRecords` integer, required

## Other responses

- `4XX` — Generic response error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)