Purchase a given inbound number.
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
XML end point
All requests are submitted through the HTTP POST or GET method using UTF-8 encoding and URL encoded values.
All requests require your API credentials (api_key & api_secret), which you can find under "API Settings" in TheTexting Dashboard.
|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)
JSON Response (Success)
"Response": "Number: 16787188829 has been successfully purchased",
XML Response (Success)
<Response>Number: 16787188829 has been successfully purchased</Response>
JSON Response (Failure)
"ErrorMessage": "Parameters Missing",
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>
|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.|
If you have set Incoming Reply callback URL in your profile or with the number, we will send you the following parameters.
https://YOURCALLBACKURL.COM/YOURPAGE?from=123456&to=1556985&text=This is a test message.&datetime=Jun 9 2017 09:41 AM&cost=0.00
|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.|