Number » Buy

Purchase a given inbound number.


Base URL


All requests to TheTexting must be submitted to the base URL. TheTexting provides you with an option of a response as a JSON object, or an XML string - you get to choose which response by selecting the appropriate base URL for your request.


JSON end point

https://www.thetexting.com/rest/sms/json

XML end point

https://www.thetexting.com/rest/sms/xml

HTTP Methods

All requests are submitted through the HTTP POST or GET method using UTF-8 encoding and URL encoded values.

Expected "Content-Type" for POST is "application/x-www-form-urlencoded", however we also support "application/json", "application/jsonrequest", "application/x-javascript", "text/json", "text/javascript", "text/x-javascript", "text/x-json" when posting parameters as a JSON object.


Parameters

All requests require your API credentials (api_key & api_secret), which you can find under "API Settings" in TheTexting Dashboard.

Parameter Description
api_key Required. Your API Key. Ex: api_key=2f0ihf5656lfu03jl
api_secret Required. Your API Secret. Ex: api_secret=cluol3434qwfc0lg
number Required. Number to buy.

Sample URL (POST)

https://www.thetexting.com/rest/sms/json/number/buy?api_key=your_api_Key&api_secret=your_api_secret&number=16787188829

JSON Response (Success)

{

    "Response": "Number: 16787188829 has been successfully purchased",

    "ErrorMessage": "",

    "Status": 0

}


XML Response (Success)

<TheTexting xmlns:i="http://www.w3.org/2001/XMLSchema-instance">

    <ErrorMessage></ErrorMessage>

    <Response>Number: 16787188829 has been successfully purchased</Response>

    <Status>0</Status>

</TheTexting>


JSON Response (Failure)

{
"Response": null,
"ErrorMessage": "Parameters Missing",
"Status": 2
}


XML Response (Failure)

<TheTexting xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<ErrorMessage>Parameters Missing</ErrorMessage>
<Response i:nil="true"/>
<Status>2</Status>
</TheTexting>

Respond Codes

Code Meaning
0 Request is successful
1 Request has failed.
2 Parameters are missing.
3 Credentials are invalid.
4 Parameters are invalid.
5 Result has returned empty.
6 Status is invalid.

Callback Response

If you have set Incoming Reply callback URL in your profile or with the number, we will send you the following parameters.


Sample URL

https://YOURCALLBACKURL.COM/YOURPAGE?from=123456&to=1556985&text=This is a test message.&datetime=Jun 9 2017 09:41 AM&cost=0.00

Parameter Description
From Sender number of this message.
To Receiver number of this message.
Text Text of the incoming message received.
Date-time Date & Time when this message was received.
Cost Cost of the message if any.