---
title: "Retrieve an inexplicit number order"
method: GET
path: "/inexplicit_number_orders/{id}"
tags: ["Inexplicit Number Orders"]
---

# Retrieve an inexplicit number order

`GET /inexplicit_number_orders/{id}`

Get an existing inexplicit number order by ID.

## Path parameters

- `id` string, uuid, required

## 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-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)