Text CALL to 88440
info@voodooSMS.com

+44 (0)1484 599 311

Login Free Account

Developer Tools

Free Account

Received SMS

This API call will return any inbound SMS received.

Definition

http:// or https:// www.voodooSMS.com/vapi/server/getSMS

METHODS

GET

POST

Parameters

Required Fields

to:

Ending date of required data (Optional)

from:

Starting date of required data (Optional)

keyword:

Filter for message body (Optional)

vmn:

The number the SMS was sent to, Format Ex: (447xxxxxxxxx) (Optional)

eref:

Your external reference number from the original Send SMS (Optional)

uid:

System allocated username for API user configured within the VoodooSMS.com Portal in ‘Send SMS>API Management’

pass:

System password for API user configured within the VoodooSMS.com Portal in ‘Send SMS>API Management’

Received SMS Dummy Text

Request


<?php
switch($_SERVER["REQUEST_METHOD"]) {
    case "GET":
        $uid = htmlspecialchars($_GET["uid"]);
        $pass = htmlspecialchars($_GET["pass"]);
        $from = htmlspecialchars($_GET["from"]);
        $to = htmlspecialchars($_GET["to"]);
        $keyword = htmlspecialchars($_GET["keyword"]);
        $vmn = htmlspecialchars($_GET["vmn"]);
        $eref = htmlspecialchars($_GET["eref"]);
        break;
    case "POST":
        $uid = htmlspecialchars($_GET["uid"]);
        $pass = htmlspecialchars($_GET["pass"]);
        $from = htmlspecialchars($_GET["from"]);
        $to = htmlspecialchars($_GET["to"]);
        $keyword = htmlspecialchars($_GET["keyword"]);
        $vmn = htmlspecialchars($_GET["vmn"]);
        $eref = htmlspecialchars($_GET["eref"]);
        break;
}

$url = 'https://www.voodoosms.com/vapi/server/getSMS?uid='.$uid.'&pass='.$pass.'&from='.$from.
        '&to='.$to."&keyword=".$keyword."&vmn=".$vmn."&eref=".$eref;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
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);
?>

import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import java.net.URLConnection;
import java.net.URLEncoder;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.HttpSession;

public class Servlet extends HttpServlet {
    public void doGet( HttpServletRequest request, HttpServletResponse response ) throws ServletException, IOException {

        if(request.getAttribute("uid") != null && request.getAttribute("pass") != null
            && request.getAttribute("from") != null && request.getAttribute("to") != null
            && request.getAttribute("keyword") != null) {
        	String charset = "UTF-8";
            String query = String.format("uid=%s&pass=%s&from=%s&to=%s&keyword=%s",
             URLEncoder.encode(request.getAttribute("uid").toString(), charset),
             URLEncoder.encode(request.getAttribute("pass").toString(), charset),
             URLEncoder.encode(request.getAttribute("from").toString(), charset),
             URLEncoder.encode(request.getAttribute("to").toString(), charset),
             URLEncoder.encode(request.getAttribute("keyword").toString(), charset));
             String url = "www.voodoosms.com/vapi/server/getSMS";

            URLConnection connection = new URL(url + "?" + query).openConnection();
            connection.setRequestProperty("Accept-Charset", charset);
            InputStream reqres = connection.getInputStream();
            // reqres contains the request output
        }
        else {
        	// Wrong parameters
        }
    }
    public void doPost( HttpServletRequest request, HttpServletResponse response ) throws ServletException, IOException {
    	// Same as GET
    }
}

var http = require('http');
var https = require('https');
var querystring = require('querystring');
var url = require('url');

var server = http.createServer(function(req, res) {

    var url_parts = url.parse(req.url, true);
    var query = url_parts.query;
    var uid = query.uid;
    var pass = query.pass;
    var from = query.from;
    var to = query.to;
    var keyword = query.keyword;

    if(uid && pass && orig && dest && msg && format) {
        var get_data = querystring.stringify({
          "uid" : uid, "pass": pass, "from": from, "to": to, "keyword" : keyword
        });

        var options = {
            host: 'www.voodoosms.com',
            path: '/vapi/server/getSMS?' + get_data
        }

        https.get(options, function(reqres) {
          reqres.on('data', function(chunk) {
            res.end(chunk);
          })
        });

    }
    else
      res.end("Wrong parameters");
});

server.listen(8080);

require 'net/http'
require 'json'

class Controller < ApplicationController
    def index
    uid = params[:uid]
    pass = params[:pass]
    from = params[:from]
    to = params[:to]
    keyword = params[:keyword]

    if uid and pass and dest and orig and msg and form
        uri = "?uid=" + uid + "&pass=" + pass + "&from=" + from + "&to=" + to + "&keyword=" + keyword
    else
        uri = 0
    end

    if uri != 0
        url = URI.parse('http://www.voodoosms.com/vapi/server/getSMS' + uri)
        uri = URI(url)
        response = Net::HTTP.get(uri)
        @res = response
    else
        @res = "Wrong parameters"
    end
  end
end

from django.http
import HttpResponse, HttpRequest
import urllib2

def index(request):

    if request.method == 'GET':
        uid = request.GET.get('uid', '')
        pas = request.GET.get('pass', '')
        form = request.GET.get('from', '')
        to = request.GET.get('to', '')
        keyword = request.GET.get('keyword', '')
    elif request.method == 'POST':
        uid = request.GET.get('uid', '')
        pas = request.GET.get('pass', '')
        form = request.GET.get('from', '')
        to = request.GET.get('to', '')
        keyword = request.GET.get('keyword', '')

    if uid and pas and form and to and keyword :
        u = "?uid=%s&pass=%s&from=%s&to=%s&keyword=%s" % (uid, pas, form, to, keyword)
    else :
        u = 0

    if u :
        res = urllib2.urlopen("https://voodoosms.com/vapi/server/getSMS" + u).read()
        return HttpResponse(res)
    else :
        return HttpResponse("Wrong parameters")

using System;
using System.Net.Http;
using System.Web;

var client = new HttpClient();

//Get the parameters, either GET or POST request
    string uid = HttpContext.Current.Server.HtmlEncode(Request["uid"]);
    string pass = HttpContext.Current.Server.HtmlEncode(Request["pass"]);
    string from2 = HttpContext.Current.Server.HtmlEncode(Request["from"]);
    string to = HttpContext.Current.Server.HtmlEncode(Request["to"]);
    string keyword = HttpContext.Current.Server.HtmlEncode(Request["keyword"]);

//Exit if one or more parameters is missing
    if(String.IsNullOrEmpty(uid) || String.IsNullOrEmpty(pass) || String.IsNullOrEmpty(from2)
    || String.IsNullOrEmpty(to) || String.IsNullOrEmpty(keyword)) System.Environment.Exit(1)

// Send the async request
    HttpResponseMessage response = await client.GetAsync(
    "https://www.voodoosms.com/vapi/server/getSMS?uid=" + uid + "&pass=" + pass
    + "&from=" + from2 + "&to=" + to + "&keyword=" + keyword);

// Get the response content
HttpContent responseContent = response.Content;

// Get the stream of the content and write the output
using (var reader = new StreamReader(await responseContent.ReadAsStreamAsync()))
{
Console.WriteLine(await reader.ReadToEndAsync());
}

Response


<xml>
   <result>200 OK</result>
   <messages>
      <message>
         <Message>yes approved, next month ceremony hai ..</Message>
         <TimeStamp>2014-10-29 18:12:18</TimeStamp>
         <Originator>447709364755</Originator>
      </message>
      <message>
         <Message>Cool, was nice to catch up with u yesterday after a long time</Message>
         <TimeStamp>2014-10-29 18:13:20</TimeStamp>
         <Originator>447709364755</Originator>
      </message>
   </messages>
</xml>
...
...
{
    "requestError": {
        "serviceException": {
            "messageId": "UNAUTHORIZED",
            "text": "Invalid login details"
        }
    }
}
METHOD POST
Request Headers
Accept: */*
Referer: http:// or https:// www.voodoosms.com/vapi/server
authorization: Basic ZGZkZjpzZGZkZg==
accept-encoding: gzip, deflate
content-type: application/json
content-length: 64
URL http:// or https:// www.voodoosms.com/vapi/server/sendSMS
Request Data
{
    "from": "447711112244",
    "to": [
        "447788112233"
    ],
    "text": "tsdsdsd"
}
Status
Response Headers
access-control-allow-origin: *
access-control-allow-methods: GET, POST, PUT, PATCH, DELETE, COPY, HEAD, OPTIONS, LINK, UNLINK,
PURGE access-control-allow-headers: Authorization, Content-Type, X-Enrollment-Token
content-type: application/json;charset=UTF-8
content-length: 97
date: Tue, 27 Dec 2016 08:17:07 GMT
connection: close
server: SMS API
strict-transport-security: max-age=16000000; includeSubDomains; preload;