When you call the forget API endpoint, the number will be instantly added to your blacklist so that no further SMS is sent to the CLI (destination number) supplied. Then, within 24 hours of the time of the request the VoodooSMS platform will work through your contact lists, sent SMS, received SMS, Blacklist etc to either delete the CLI or mask the CLI from your records along with the content of the SMS. In the case of outbound SMS, we will have the CLI masked so that only the first 6 digits remain, making it impossible to identify the destination number, and the body of the SMS removed, e.g. API / Web SMS, this is purely from an accounting perspective so that the credit spend can be tracked.
Once the process is complete, the CLI / Destination number will not be stored anywhere on our platform, this includes your blacklist. If an SMS is sent via Web SMS / API etc via your account to the CLI the VoodooSMS platform will send it, even if you have made a forget request prior.
https://
www.voodooSMS.com/vapi/server/forget
Request
<?php
switch($_SERVER["REQUEST_METHOD"]) {
case "GET":
$uid = htmlspecialchars($_GET["uid"]);
$pass = htmlspecialchars($_GET["pass"]);
$cc = htmlspecialchars($_GET["cc"]);
$cli = htmlspecialchars($_GET["cli"]);
$format = htmlspecialchars($_GET["format"]);
break;
case "POST":
$uid = htmlspecialchars($_POST["uid"]);
$pass = htmlspecialchars($_POST["pass"]);
$cc = htmlspecialchars($_POST["cc"]);
$cli = htmlspecialchars($_POST["cli"]);
$format = htmlspecialchars($_POST["format"]);
break;
}
$url = 'https://www.voodoosms.com/vapi/server/forget?uid='.$uid.'&pass='.$pass.
'&cc='.$cc.'&cli='.$cli.'&format='.$format;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
// Download the given URL, and return output
$output = curl_exec($ch);
echo $output . " " . curl_error($ch);
// Close the cURL resource, and free system resources
curl_close($ch);
?>
Response
<xml>
<result>202</result>
<message>Your request has been accepted and is pending</message>
<reference>BWwmkoxO3YTfpEt</reference>
<date>2018-05-02 10:33:37</date>
</xml>
This API call will check the status on any given day of previous API calls to forget a CLI (destination number). This API call will return the current status.
https://
www.voodooSMS.com/vapi/server/forgetstatus
Request
<?php
switch($_SERVER["REQUEST_METHOD"]) {
case "GET":
$uid = htmlspecialchars($_GET["uid"]);
$pass = htmlspecialchars($_GET["pass"]);
$date = htmlspecialchars($_GET["date"]);
$format = htmlspecialchars($_GET["format"]);
break;
case "POST":
$uid = htmlspecialchars($_POST["uid"]);
$pass = htmlspecialchars($_POST["pass"]);
$date = htmlspecialchars($_POST["date"]);
$format = htmlspecialchars($_POST["format"]);
break;
}
$url = 'https://www.voodoosms.com/vapi/server/forgetstatus?uid='.$uid.'&pass='.$pass.'&date='
.$date.'&format='.format;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
// Download the given URL, and return output
$output = curl_exec($ch);
echo $output." ".curl_error($ch);
// Close the cURL resource, and free system resources
curl_close($ch);
?>
Response
<xml>
<item>
<result>202</result>
<message>Your request has been accepted and is pending removal</message>
<reference>BWwmkoxO3YTfpEt</reference>
<date>2018-05-17 00:23:37</date>
</item>
</xml>
Or if more than one request has been made and is still pending:
<xml>
<item>
<result>202</result>
<message>Your request has been accepted and is pending removal</message>
<reference>BWwmkoxO3YTfpEt</reference>
<date>2018-05-17 00:23:37</date>
</item>
<item>
<result>202</result>
<message>Your request has been accepted and is pending removal</message>
<reference>yt9jDd6EXPnJBaT</reference>
<date>2018-05-17 00:25:17</date>
</item>
</xml>
For the check status (forgetstatus), this will return a list of your outstanding requests referenced by the reference value returned on the original forget request. Once a request has been completed, this status will change as per the following example:
<xml>
<item>
<result>200</result>
<message>The CLI has been removed</message>
<reference>BWwmkoxO3YTfpEt</reference>
<date>2018-05-17 03:00:15</date>
</item>
</xml>