---
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`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/10dlc/phone_number_campaigns`
- Auth: HTTP bearer

Returns phone-number-to-campaign assignments for the authenticated account. Apply the documented filters and pagination parameters to narrow the result set.

## 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.
    - `tmobileNumberMappingStatus` string: The T-Mobile assignment status of the number.
    - `nonTmobileNumberMappingStatus` string: The assignment status of the number towards other carriers.
    - `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

## Changes

- **2026-10-21** `67df31283a8a`: 1 breaking, 1 info
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `4XX`
  - added the optional property `errors/items/description` to the response with the `4XX` status
- **2026-10-15** `a72569d69430`: 1 breaking, 3 info
  - the `errors/items/code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `4XX`
  - added the optional property `errors/items/meta` to the response with the `4XX` status
  - added the optional property `records/items/nonTmobileNumberMappingStatus` to the response with the `200` status
  - added the optional property `records/items/tmobileNumberMappingStatus` to the response with the `200` status

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/10dlc/phone_number_campaigns/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)