v47

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-181,0851,7264.5 MB

Phone Number Block Orders

Create a number block order

Creates a phone number block order.

post/number_block_orders

Request body

idstring uuid

record_typestring

starting_numberstring required

Starting phone number block

rangeinteger required

The phone number range included in the block.

phone_numbers_countinteger

The count of phone numbers in the number order.

connection_idstring

Identifies the connection associated with this phone number.

messaging_profile_idstring

Identifies the messaging profile associated with the phone number.

status'pending' | 'success' | 'failure'

The status of the order.

customer_referencestring

A customer reference string for customer look ups.

created_atstring date-time

An ISO 8901 datetime string denoting when the number order was created.

updated_atstring date-time

An ISO 8901 datetime string for when the number order was updated.

requirements_metboolean

True if all requirements are met for every phone number, false otherwise.

errorsstring

Errors the reservation could happen upon

Example request

{
  "starting_number": "+19705555000",
  "range": 10
}

Response

Successful response with details about a number block order.

Example response

{
  "data": {
    "id": "12ade33a-21c0-473b-b055-b3c836e1c292",
    "starting_number": "+19705555000",
    "range": 10,
    "record_type": "number_block_order",
    "connection_id": "346789098765567",
    "messaging_profile_id": "abc85f64-5717-4562-b3fc-2c9600",
    "phone_numbers_count": 10,
    "status": "pending",
    "customer_reference": "MY REF 001",
    "created_at": "2018-01-01T00:00:00.000000Z",
    "updated_at": "2018-01-01T00:00:00.000000Z",
    "requirements_met": true
  }
}