Create Number


URL:

https://api2.protexting.com/v1/numbers/create?access_token=your_access_token

 

* 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.


Method:

POST

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 "https://api2.protexting.com/v1/numbers/create?access_token=your_access_token" -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
X-Rate-Limit-Reset

Example Response Body:

{
    "Number":16463498xxx,
    "Status_Id": 0,
"Status_Description":"Active",
"Blocked_Date" : null }
<response>
    <Number>16463498xxx</Number>
    <Status_Id>0</Status_Id>
<Status_Description>Active</Status_Description>
<Blocked_Date/>
</response>

HTTP Status Codes:

The standard HTTP Status Codes are used. More information is available here: http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml

Error Codes:

Error Codes and Examples here »

 

Statuses:

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