Phone Numbers API - Get the Status of a Direct Order

Once you create a direct order, it moves through several processing statuses ('accepted', 'in progress', 'resolved', 'rejected', 'cancelled'). This method can be used to retrieve the current status as well as other details of a direct order you have created.

Reference Page

GET /v1/phone_numbers/direct_orders/{order_id}

Request

GET /v1/phone_numbers/direct_orders/632a70h3-u893-48e2-jjl2-ou83k278yi28 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

Response

{
  "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": "resolved",
      "last_date_modified": "2019-10-21T17:40:22.000Z",
      "country_iso2": "BE",
      "quantity": 4,
      "capabilities": {
        "sms": true,
        "voice": true
      },
      "numbers": [
        "32460213960",
        "32460200563",
        "32460200562",
        "32460200561"
      ],
      "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
    }
  ]
}

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. 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. For Path Params enter the order ID for one of your direct orders.
3. Click Send.
4. Click the Code Generation tab and use the Language and Library menus to choose the language you want your code snippet in.