Phone Numbers API - Create a Direct Order

Use this method to direct order one or more phone numbers from TeleSign.

📘

NOTE:

In general, the rules that apply to creating a lease with the Phone Numbers API also apply to direct orders. If you order an SMS-capable number, support for SMS Verify, SMS, and Inbound SMS are added. If you order a voice-capable number, support for Voice Verify and Voice are added.

Reference Page

POST /v1/phone_numbers/direct_orders

Partial Order Match

By default the service only returns numbers when it can deliver the full quantity requested. It is also possible to enable partial order matching in the request, in which case the service returns as many numbers as it can up to a maximum equal to your specified quantity.

Example

Request

POST https://rest-ww.telesign.com/v1/phone_numbers/direct_orders HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:vjE/ZDfPvDkuGNsuqCFFO4neYIs=
Content-Type: application/x-www-form-urlencoded; charset=utf-8
Host: rest-ww.telesign.com
country_iso2=BE&sms_capable=true&voice_capable=true&quantity=4&number_pattern=324&email=HealthBelgium%40gmail.com&contact_name=Ms%20Health%20Center%20Manager&use_case=Business%20notifications%20and%20reminders&description=Continuous%20numbers%20array%20preferred&city=Antwerp&city=Brussels&partial_order_match=true

Response

{
  "data": {
    "order_id": "679a34h2-h949-79f4-odl2-ou38b239vk32",
    "order_accepted_date": "Wed, 23 Oct 2019 18:23:53 -0000",
    "status": "accepted",
    "last_date_modified": null,
    "country_iso2": "BE",
    "quantity": 4,
    "capabilities": {
      "sms": true,
      "voice": true
    },
    "numbers": [],
    "number_type": "mobile",
    "number_pattern": "324",
    "pattern_method": "prefix",
    "email": "[email protected]",
    "contact_name": "Ms Health Center Manager",
    "use_case": "Business notifications and reminders",
    "description": "Continuous numbers array preferred",
    "city": [
      "Antwerp",
      "Brussels"
    ],
    "partial_order_match": true
  }
}

Use Cases

Common use cases for this method include:

  • Order phone numbers for a specific country and number type you could not find in our inventory using the Search for a Phone Number to Lease method.
  • Order and reserve phone numbers that require an address validation procedure to comply with a regulatory process.
  • Order phone numbers from a certain country without any previous search.

🚧

Restrictions by Country

A phone number is subject to different regulatory compliance rules depending on the associated country. Within each country, rules may also differ by number type. These rules may require address and identity validation or impose specific service limitations. Be sure to observe all regulatory compliance rules when obtaining phone numbers through TeleSign.

TeleSign can assist you in completing any required validation documents and pass them on your behalf to the appropriate regulatory body. Contact our Customer Support Team if you need additional help obtaining numbers for countries with regulatory restrictions.

Billing and Pricing

As a post-paid customer, an invoice item is generated for the current month that includes the recurring fee and recurrence period for each phone number included in your direct order. No end is placed on the generated order.

Phone number pricing information can be found at Pricing for TeleSign Phone Numbers.


Did this page help you?