Create Number



* if the account is set with credit card billing, you will be able to create 1 long code every 2 minutes, otherwise the transaction will be declined.



Request parameters:

* required parameters

Parameter Description
Country String,The two character country code in ISO 3166-1 alpha-2 format. see here »
Prefix String, Starts with prefix to search for create.

Response parameters:

Parameter Description
Number  String
Status_Id  Integer, view statuses »
Status_Description  String, view statuses » 
Blocked_Date  String, Date Time

Example Request:

curl -i -H "Accept:application/json" -XPOST "" -d '{"Country":"US","Prefix":"64634"}'


Example Response Headers:

Status Code: 201 Created
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Connection: Keep-Alive
Content-Length: 243
Content-Type: application/json; charset=UTF-8
Keep-Alive: timeout=5, max=100
Pragma: no-cache
X-Powered-By: PHP/5.6.2
X-Rate-Limit-Limit: 60
X-Rate-Limit-Remaining: 59

Example Response Body:

    "Status_Id": 0,
"Blocked_Date" : null }

HTTP Status Codes:

The standard HTTP Status Codes are used. More information is available here:

Error Codes:

Error Codes and Examples here »



Status Id Status Description
0 Active
1 Inactive
301 Temporarily blocked.
302 Permanently blocked.