Check out our upcoming events and meetups! View events →
Create an inexplicit number order to programmatically purchase phone numbers without specifying exact numbers.
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
const inexplicitNumberOrder = await client.inexplicitNumberOrders.create({
ordering_groups: [
{
count_requested: 'count_requested',
country_iso: 'US',
phone_number_type: 'phone_number_type',
},
],
});
console.log(inexplicitNumberOrder.data);{
"data": {
"id": "<string>",
"connection_id": "<string>",
"messaging_profile_id": "<string>",
"customer_reference": "<string>",
"billing_group_id": "<string>",
"ordering_groups": [
{
"country_iso": "<string>",
"phone_number_type": "<string>",
"count_requested": 123,
"count_allocated": 123,
"status": "pending",
"national_destination_code": "<string>",
"phone_number[starts_with]": "<string>",
"phone_number[ends_with]": "<string>",
"phone_number[contains]": "<string>",
"administrative_area": "<string>",
"strategy": "always",
"quickship": true,
"exclude_held_numbers": true,
"error_reason": "<string>",
"orders": [
{
"number_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sub_number_order_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}Documentation Index
Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
Use this file to discover all available pages before exploring further.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Group(s) of numbers to order. You can have multiple ordering_groups objects added to a single request.
Show child attributes
Connection id to apply to phone numbers that are purchased
Messaging profile id to apply to phone numbers that are purchased
Reference label for the customer
Billing group id to apply to phone numbers that are purchased
Successful response with details about an inexplicit number order.
Show child attributes
Was this page helpful?
import Telnyx from 'telnyx';
const client = new Telnyx({
apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted
});
const inexplicitNumberOrder = await client.inexplicitNumberOrders.create({
ordering_groups: [
{
count_requested: 'count_requested',
country_iso: 'US',
phone_number_type: 'phone_number_type',
},
],
});
console.log(inexplicitNumberOrder.data);{
"data": {
"id": "<string>",
"connection_id": "<string>",
"messaging_profile_id": "<string>",
"customer_reference": "<string>",
"billing_group_id": "<string>",
"ordering_groups": [
{
"country_iso": "<string>",
"phone_number_type": "<string>",
"count_requested": 123,
"count_allocated": 123,
"status": "pending",
"national_destination_code": "<string>",
"phone_number[starts_with]": "<string>",
"phone_number[ends_with]": "<string>",
"phone_number[contains]": "<string>",
"administrative_area": "<string>",
"strategy": "always",
"quickship": true,
"exclude_held_numbers": true,
"error_reason": "<string>",
"orders": [
{
"number_order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"sub_number_order_ids": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}