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

# List phone number assignment orders

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

Returns a list of orders for a campaign.

#### 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.

- OrderListResponse — Response containing a list of orders.
  - `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` Order[] — List of orders.
    - `id` string, uuid, required — Universal Unique Identifier.
    - `state` string — The current state of the order.
    - `processed_at` string, date-time — Timestamp when the order was processed.
    - `created_at` string, date-time — Timestamp when the order was created.
    - `updated_at` string, date-time — Timestamp when the order was last updated.
    - `status_callback_url` string — Optional: Specify a URL to receive webhook notifications when your number assignment order and the number assignments that belong to it change state. See the [10DLC status callback](/docs/apis/rest/campaign-registry/webhooks/ten-dlc-status-callback) docs for the webhook payload.

## Other responses

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

---

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