Want to provide feedback?

Write to docs@telesign.com.

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 /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
application/x-www-form-urlencoded
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
application/json
{
  "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": "HealthBelgium@gmail.com",
    "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.

Next Steps

Check out some other related pages:

  • Get the Status of a Direct Order - Learn how to use the Phone Numbers API to retrieve the status of a specified direct order and to track its progress.
  • List Your Direct Orders - Learn how to use the Phone Numbers API to retreive a list of all previously created direct orders, including the status for each.
  • Cancel a Direct Order - Learn how to use the Phone Numbers API to cancel a specified direct order.