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.