---
title: "List campaign phone number assignments"
method: GET
path: "/v1/10dlc/campaigns/{campaignId}/phone-numbers"
tags: ["10DLC"]
---

# List campaign phone number assignments

`GET /v1/10dlc/campaigns/{campaignId}/phone-numbers`

## Request

- Base URL: `https://api.zavu.dev`
- URL: `https://api.zavu.dev/v1/10dlc/campaigns/{campaignId}/phone-numbers`
- Auth: HTTP bearer

List phone numbers assigned to a 10DLC campaign. A number that was unassigned is no longer listed.

## Path parameters

- `campaignId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

List of phone number assignments.

- object
  - `items` TenDlcPhoneNumberAssignment[], required
    - `id` string, required
    - `campaignId` string, required
    - `phoneNumberId` string, required
    - `status` 'pending' | 'active' | 'failed', required: Assignment status. `pending`: sent to the carrier, not confirmed yet. `active`: the number is on the campaign and can send. `failed`: the carrier refused it; see `failureReason`. The number is free to be assigned again.
    - `failureReason` string, nullable
    - `assignedAt` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `nextCursor` string, nullable

## Other responses

- `401`: Unauthorized.
- `404`: Campaign not found.

## Changes

> 80 revisions in range; 1 not diffed.

- **2026-03-17** `dca8af164271`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/changes/v1/10dlc/campaigns/:campaignId/phone-numbers/get.md)

---

[API](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api.md) - [All operations](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zavudev/apis/zavu-unified-messaging-layer-api/revisions/75bc777b0ffb?raw)