Phone Numbers API - 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
Request
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
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": "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": "[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
},
{
"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": [
"18004017890",
"18664821930"
],
"number_type": null,
"number_pattern": null,
"pattern_method": "prefix",
"email": "[email protected]",
"contact_name": "Numbers Acquisition Manager",
"use_case": "Customers Help Desk",
"description": "1800 or 1866 prefixes",
"city": [
"New York",
"Chicago"
],
"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. You can also get a code snippet for the request.
- Click the Auth tab and for Username add your Customer ID. For Password add your API key.
- Click Send.
- Click the Code Generation tab and use the Language and Library menus to choose the language you want your code snippet in.
NOTE:
Create at least one direct order before trying out this feature, otherwise nothing is returned!
Updated 8 months ago
Did this page help you?