---
title: "Create an inexplicit number order"
method: POST
path: "/inexplicit_number_orders"
tags: ["Inexplicit Number Orders"]
---

# Create an inexplicit number order

`POST /inexplicit_number_orders`

Create an inexplicit number order to programmatically purchase phone numbers without specifying exact numbers.

## Request body

- InexplicitNumberOrderRequest
  - `ordering_groups` object[], required — Group(s) of numbers to order. You can have multiple ordering_groups objects added to a single request.
    - `country_iso` 'US' | 'CA', required — Country where you would like to purchase phone numbers. Allowable values: US, CA
    - `count_requested` string, required — Quantity of phone numbers to order
    - `phone_number_type` string, required — Number type (local, toll-free, etc.)
    - `national_destination_code` string — Filter by area code
    - `phone_number` object — Phone number search criteria
      - `starts_with` string — Filter by the starting digits of the phone number
      - `ends_with` string — Filter by the ending digits of the phone number
      - `contains` string — Filter for phone numbers that contain the digits specified
    - `administrative_area` string — Filter for phone numbers in a given state / province
    - `locality` string — Filter for phone numbers in a given city / region / rate center
    - `features` string[] — Filter for phone numbers that have the features to satisfy your use case (e.g., ["voice"])
    - `strategy` 'always' | 'never' — Ordering strategy. Define what action should be taken if we don't have enough phone numbers to fulfill your request. Allowable values are: always = proceed with ordering phone numbers, regardless of current inventory levels; never = do not place any orders unless there are enough phone numbers to satisfy the request. If not specified, the always strategy will be enforced.
    - `quickship` boolean — Filter to exclude phone numbers that need additional time after to purchase to activate. Only applicable for +1 toll_free numbers.
    - `exclude_held_numbers` boolean — Filter to exclude phone numbers that are currently on hold/reserved for your account.
  - `connection_id` string — Connection id to apply to phone numbers that are purchased
  - `messaging_profile_id` string — Messaging profile id to apply to phone numbers that are purchased
  - `customer_reference` string — Reference label for the customer
  - `billing_group_id` string — Billing group id to apply to phone numbers that are purchased

## Response `200`

Successful response with details about an inexplicit number order.

- object
  - `data` InexplicitNumberOrderResponse
    - `id` string — Unique identifier for the inexplicit number order
    - `connection_id` string — Connection id to apply to phone numbers that are purchased
    - `messaging_profile_id` string — Messaging profile id to apply to phone numbers that are purchased
    - `customer_reference` string — Reference label for the customer
    - `billing_group_id` string — Billing group id to apply to phone numbers that are purchased
    - `ordering_groups` object[]
      - `country_iso` string — Country where you would like to purchase phone numbers
      - `phone_number_type` string — Number type
      - `count_requested` integer — Quantity of phone numbers requested
      - `count_allocated` integer — Quantity of phone numbers allocated
      - `status` 'pending' | 'processing' | 'failed' | 'success' | 'partial_success' — Status of the ordering group
      - `national_destination_code` string — Filter by area code
      - `phone_number[starts_with]` string — Filter by the starting digits of the phone number
      - `phone_number[ends_with]` string — Filter by the ending digits of the phone number
      - `phone_number[contains]` string — Filter for phone numbers that contain the digits specified
      - `administrative_area` string — Filter for phone numbers in a given state / province
      - `strategy` 'always' | 'never' — Ordering strategy used
      - `quickship` boolean — Filter to exclude phone numbers that need additional time after to purchase to activate. Only applicable for +1 toll_free numbers.
      - `exclude_held_numbers` boolean — Filter to exclude phone numbers that are currently on hold/reserved for your account.
      - `error_reason` string — Error reason if applicable
      - `orders` object[] — Array of orders created to fulfill the inexplicit order
        - `number_order_id` string, uuid, required — ID of the main number order
        - `sub_number_order_ids` string[], required — Array of sub number order IDs
      - `created_at` string, date-time — ISO 8601 formatted date indicating when the ordering group was created
      - `updated_at` string, date-time — ISO 8601 formatted date indicating when the ordering group was updated
    - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created
    - `updated_at` string, date-time — ISO 8601 formatted date indicating when the resource was updated

## Other responses

- `400` — Bad request, the request was unacceptable, often due to missing a required parameter.
- `401` — Unauthorized
- `404` — The requested resource doesn't exist.
- `422` — Unprocessable entity. Check the 'detail' field in response for details.
- `500` — Unexpected error

---

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