---
title: "List phone number assignments"
method: GET
path: "/api/relay/rest/registry/beta/campaigns/{id}/numbers"
tags: ["Campaign Registry: Phone Number Assignments"]
---

# List phone number assignments

`GET /api/relay/rest/registry/beta/campaigns/{id}/numbers`

## Request

- Base URL: `https://{Your_Space_Name}.signalwire.com`
- URL: `https://{Your_Space_Name}.signalwire.com/api/relay/rest/registry/beta/campaigns/{id}/numbers`
- Auth: HTTP basic

Lists the project phone numbers bound to one US 10-digit long code (10DLC) campaign. These assignments determine which numbers may send traffic for the registered use case. Use [List phone number assignment orders](/docs/apis/rest/campaign-registry/phone-number-assignments/list-orders) to monitor batch requests that create the bindings.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Messaging_ and _Numbers_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required: Universal Unique Identifier.

## Query parameters

- `filter_state` string

## Response `200`

The request has succeeded.

- AssignedNumberListResponse: Response containing a list of assigned numbers.
  - `links` PaginationLinks: Pagination links for list responses.
    - `self` string, required: Link to the current page.
    - `first` string, required: Link to the first page.
    - `next` string: Link to the next page. Only present when there are more results.
    - `prev` string: Link to the previous page. Only present when not on the first page.
  - `data` AssignedNumber[]: List of assigned numbers.
    - `id` string, uuid, required: Universal Unique Identifier.
    - `state` string: The current state of the assignment.
    - `campaign_id` string, uuid: Universal Unique Identifier.
    - `phone_number` AssignedPhoneNumber: Phone number details in an assignment.
      - `id` string, uuid: Universal Unique Identifier.
      - `name` string: The name of the phone number.
      - `number` string: The phone number in E.164 format.
      - `status_callback_url` string: Optional: Specify a URL to receive webhook notifications. See the [10DLC status callback](/docs/apis/rest/webhooks/ten-dlc-status-callback) docs for the webhook payload.
    - `created_at` string, date-time: Timestamp when the assignment was created.
    - `updated_at` string, date-time: Timestamp when the assignment was last updated.

## Other responses

- `401`: Access is unauthorized.
- `404`: The server cannot find the requested resource.
- `500`: An internal server error occurred.

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) - [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalwire/apis/signalwire-rest-api/revisions/7307749294e0?raw)