List Your Direct Orders

Use this method to retrieve a list of all the direct orders of phone numbers you have initiated with TeleSign, so you can review the status and other details of each one.

Reference Page

GET /v1/phone_numbers/direct_orders

GET /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
  "pagination": {
    "page": 1,
    "total_pages": 1,
    "page_size": 10
  "data": [
      "order_id": "632a70h3-u893-48e2-jjl2-ou83k278yi28",
      "order_accepted_date": "2019-10-21T17:33:22.000Z",
      "status": "in progress",
      "last_date_modified": "2019-10-21T17:38:22.000Z",
      "country_iso2": "BE",
      "quantity": 4,
      "capabilities": {
        "sms": true,
        "voice": true
      "numbers": [],
      "number_type": "mobile",
      "number_pattern": "324",
      "pattern_method": "prefix",
      "email": "",
      "contact_name": "Ms Health Center Manager",
      "use_case": "Business notifications and reminders",
      "description": "Continuous numbers array preferred",
      "city": [
      "partial_order_match": true
      "order_id": "632a70h3-u893-48e2-tn38-ou83k278yi93",
      "order_accepted_date": "2019-09-21T17:33:22.000Z",
      "status": "resolved",
      "last_date_modified": "2019-09-21T17:38:22.000Z",
      "country_iso2": "US",
      "quantity": 2,
      "capabilities": {
        "sms": true,
        "voice": true
      "numbers": [
      "number_type": null,
      "number_pattern": null,
      "pattern_method": "prefix",
      "email": "",
      "contact_name": "Numbers Acquisition Manager",
      "use_case": "Customers Help Desk",
      "description": "1800 or 1866 prefixes",
      "city": [
        "New York",
      "partial_order_match": null

Try It

If you have been granted access and credentials for the Phone Numbers API and you have created at least one direct order, you can try a test request using this method in the Phone Numbers API Explorer below. You can also get a code snippet for the request.

  1. Click the Auth tab and for Username add your Customer ID. For Password add your API key.
  2. Click Send.
  3. Click the Code Generation tab and use the Language and Library menus to choose the language you want your code snippet in.

Create at least one direct order before trying out this feature, otherwise nothing is returned!

Phone Numbers API Explorer
NOTE: The response time shown is not indicative of regular transmission rates, and only applies to the Phone Numbers API Explorer.
Send requests directly from the browser (CORS must be enabled)
No $$.env variables are being used in this request.

Next Steps

Check out some other related pages: