Sign in
Campaign Registry: Phone Number Assignments

Get phone number assignment order

Retrieves one phone-number assignment order by ID so you can monitor a known batch request. Use List phone number assignment orders to discover orders for a campaign or list assignments to inspect the resulting 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.

get/api/relay/rest/registry/beta/orders/{id}

Path parameters

idstring uuid required

Universal Unique Identifier.

Unique ID of the order.

Response

The request has succeeded.

idstring uuid required

Universal Unique Identifier.

statestring

The current state of the order.

processed_atstring date-time

Timestamp when the order was processed.

created_atstring date-time

Timestamp when the order was created.

updated_atstring date-time

Timestamp when the order was last updated.

status_callback_urlstring

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 for the webhook payload.

Example response

{
  "state": "pending",
  "status_callback_url": "https://example.com/handle_callback"
}

Changes

No changes found, but 3 of the 137 revisions have a changelog that could not be searched — this endpoint may have changed in one of them.