Number » Cancel

Cancel a given inbound number subscription.

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

Sample URL (POST)

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

JSON Response (Success)

{
    "Response": "Number : 16787188829 has been successfully canceled.",
    "ErrorMessage": "",
    "Status": 0
}

XML Response (Success)

<TheTexting xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <ErrorMessage></ErrorMessage>
    <Response>Number : 16787188829 has been successfully canceled.</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.