Introduction
Mobile phone number serves as the ultimate user identity in digital universe. Digital applications whether on web or on mobile verify mobile numbers of their users to ensure their authenticity. To address this growing need, Message Central has developed a reliable, quick and cost-effective mobile number verification service called Verify Now.
Help and Support
For implementation support and any feedback, please reach out to us at: operations@messagecentral.com
API Request and Response
The API will only accept requests from the service provider via the API Endpoint URI shared with the service provider and from whitelisted IP addresses over HTTP, partner to provide a list of source IP.
REST API Base URL’s:
All Platform API endpoints below should be prefixed with the following URL:
https://cpaas.messagecentral.com
Generate Token
To generate Auth token for Send OTP & Validate OTP header, please sign up on the platform.
A. Send OTP
To send otp on mobile number below are request parameters.
Request URL Path:
/verification/v2/verification/send
Response JSON:
A successful response will return a 200 status code.
{
"responseCode": Integer,
"message": "String",
"data": {
"verificationId": "String",
"mobileNumber": "String",
"responseCode": "String",
"errorMessage": "String",
"timeout": "String",
"smsCLI": "String",
"transactionId": "String"
}
}
“responseCode”:200,
“message”: “SUCCESS”,
“data”:{
“verificationId”: “20”,
“mobileNumber”: “8846735392”,
“responseCode”: “200”,
“errorMessage”: null,
“timeout”: “60”,
“smsCLI”: null,
“transactionId”: null
}
}
.newBuilder().
build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
.url("https://cpaas.messagecentral.com/verification/v2/verification/send?countryCode=91&customerId=CC0157BFAF1B94F0&flowType=SMS&mobileNumber=9990655875")
.method("POST", body)
.addHeader("authToken", "eyJhbGciOiJIUzUxMiJ9.eyJzdLIiOiJDLTMzNDMyQTVGNDlGNzQwNCIsImlhdCI6MTY5NjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrPAFpxEanH64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA")
.build();
“responseCode”:200,
“message”: “SUCCESS”,
“data”:{
“verificationId”: “20”,
“mobileNumber”: “8846735392”,
“responseCode”: “200”,
“errorMessage”: null,
“timeout”: “60”,
“smsCLI”: null,
“transactionId”: null
}
}
var options = {
'method': 'POST',
'url':'https://cpaas.messagecentral.com/verification/v2/verification/send?countryCode=91&customerId=C-C0157BFAF1B94F0&flowType=SMS&mobileNumber=9990655875',
'headers': {
'authToken': 'eyJhbGciOiJIUzUxMiJ9.eyJzdLIiOiJDLTMzNDMyQTVGNDlGNzQwNCIsImlhdCI6MTY5NjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrPAFpxEanH64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
“responseCode”:200,
“message”: “SUCCESS”,
“data”:{
“verificationId”: “20”,
“mobileNumber”: “8846735392”,
“responseCode”: “200”,
“errorMessage”: null,
“timeout”: “60”,
“smsCLI”: null,
“transactionId”: null
}
}
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request-
>setUrl('https://cpaas.messagecentral.com/verification/v2/verification/sendcountryCode=91&customerId=CC0157BFAF1B94F0&flowType=SMS&mobileNumber=9990655875');$request->setMethod(HTTP_Request2::METHOD_POST);$request->setConfig(array('follow_redirects' => TRUE));
$request->setHeader(array(
'authToken' => 'eyJhbGciOiJIUzUxMiJ9.eyJzdLIiOiJDLTMzNDMyQTVGNDlGNzQwNCIsImlhdCI6MTY5NjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrPAFpxEanH64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA'
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}
“responseCode”:200,
“message”: “SUCCESS”,
“data”:{
“verificationId”: “20”,
“mobileNumber”: “8846735392”,
“responseCode”: “200”,
“errorMessage”: null,
“timeout”: “60”,
“smsCLI”: null,
“transactionId”: null
}
}
url = "https://cpaas.messagecentral.com/verification/v2/verification/send?countryCode=XX&customerId=CXC0157XXXF1B94F0&flowType=SMS&mobileNumber=999XXXX875"
payload = {}
headers = {
'authToken': 'eyJhbGciOiJIUzUxMiJ9.eyJzdLIiOiJDLTMzNDMyQTVGwNCIsImlhdCI6MTY5NjMxNDQiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGRFrPAFpx64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA'}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
“responseCode”:200,
“message”: “SUCCESS”,
“data”:{
“verificationId”: “20”,
“mobileNumber”: “8846735392”,
“responseCode”: “200”,
“errorMessage”: null,
“timeout”: “60”,
“smsCLI”: null,
“transactionId”: null
}
}
require "net/http"
url = URI("https://cpaas.messagecentral.com/verification/v2/verification/send?countryCode=XX&customerId=CXC0157XFXX1B94F0&flowType=SMS&mobileNumber=9990XXXX75")
http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["authToken"] = "eyJhbGciOiJIUzUxMiJ9.eyJzdLIiOiJDLTMyQTVGNDlGNzQwNCIsImlMTY5NjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGmpxEanH64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA"
response = http.request(request)
puts response.read_body
“responseCode”:200,
“message”: “SUCCESS”,
“data”:{
“verificationId”: “20”,
“mobileNumber”: “8846735392”,
“responseCode”: “200”,
“errorMessage”: null,
“timeout”: “60”,
“smsCLI”: null,
“transactionId”: null
}
}
var request = new HttpRequestMessage(HttpMethod.Post, "https://cpaas.messagecentral.com/verification/v2/verification/send?countryCode=XX&customerId=CXC01XXXXAF1B94F0&flowType=SMS&mobileNumber=9990XXXX75");
request.Headers.Add("authToken", "eyJhbGcIUzUxMiJ9.eyJzdLIiOiJDLTMzNDMyQTVGNDlGNzQlhdCI6MTY5NjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SR64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
“responseCode”:200,
“message”: “SUCCESS”,
“data”:{
“verificationId”: “20”,
“mobileNumber”: “8846735392”,
“responseCode”: “200”,
“errorMessage”: null,
“timeout”: “60”,
“smsCLI”: null,
“transactionId”: null
}
}
B. Validate OTP
Request URL Path:
/verification/v2/verification/validateOtp
Response JSON:
A successful response will return a 200 status code.
{
"responseCode": Integer,
"message": "String",
"data": {
"verificationId": "String",
"mobileNumber": "String",
"responseCode": "String",
"errorMessage": "String",
"timeout": "String",
"smsCLI": "String",
"transactionId": "String"
}
}
"responseCode": 200,
"message": "SUCCESS",
"data": {
"verificationId": "20",
"mobileNumber": "8846735392",
"verificationStatus": "VERIFICATION_COMPLETED",
"responseCode": "200",
"errorMessage": null,
"transactionId": null,
"authToken": eyJhbGciOiJIUzUxMiJ9.eyJzdLIiDMyQTVGNDlGNzQwNCIsImlhNjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrP64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA
}
}
.newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
.url("https://cpaas.messagecentral.com/verification/v2/verification/send?countryCode=XX&customerId=CXC0157XXAF1B94F0&flowType=SMS&mobileNumber=999XXXX875")
.method("POST", body)
.addHeader("authToken", "eyJhbGciOiJIUzUxMiJ9.eyJzdLIiODMyQTVGNDlGNzQwNCIsImlhdCIMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGmpxEanH64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA")
.build();
Response response = client.newCall(request).execute();
"responseCode": 200,
"message": "SUCCESS",
"data": {
"verificationId": "20",
"mobileNumber": "8846735392",
"verificationStatus": "VERIFICATION_COMPLETED",
"responseCode": "200",
"errorMessage": null,
"transactionId": null,
"authToken": eyJhbGciOiJIUzUxMiJ9.eyJzdLIiDMyQTVGNDlGNzQwNCIsImlhNjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrP64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA
}
}
var options = {'method': 'GET',
'url':
'https://cpaas.messagecentral.com/verification/v2/verification/validateOtp?countryCode=91&mobileNumber=999XXXX875&verificationId=XX&customerId=CXC01XXXFAF1B94F0&code=XXXX',
'headers': {
'authToken': 'eyJhbGciOiJIUzUxMiJ9.eyJzdLIiOiGNDlGNzQwNCIsImlhdCI6MTY5NjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrPAFpxEanH64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
"responseCode": 200,
"message": "SUCCESS",
"data": {
"verificationId": "20",
"mobileNumber": "8846735392",
"verificationStatus": "VERIFICATION_COMPLETED",
"responseCode": "200",
"errorMessage": null,
"transactionId": null,
"authToken": eyJhbGciOiJIUzUxMiJ9.eyJzdLIiDMyQTVGNDlGNzQwNCIsImlhNjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrP64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA
}
}
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request-
>setUrl('https://cpaas.messagecentral.com/verification/v2/verification/validateOtp?countryCode=XX&mobileNumber=999XXXX875&verificationId=XX&customerId=C-C0XXXXF1B94F0&code=XXXX');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'authToken' => 'eyJhbGciOiJIUzUxMiJ9.eyJzdLVGNDlGNzQwNCIsImlhdCI6MTY5NjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrPAFpxEanH64ADANR6pgmGEoo-T4AXXmNYh6mFvLQzI__uaA'
));
try {
$response = $request->send();
if ($response->getStatus() == 200)
{
echo $response->getBody();
}
else
{
echo 'Unexpected HTTP status: ' .$response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e)
{
echo 'Error: ' . $e->getMessage();
}
"responseCode": 200,
"message": "SUCCESS",
"data": {
"verificationId": "20",
"mobileNumber": "8846735392",
"verificationStatus": "VERIFICATION_COMPLETED",
"responseCode": "200",
"errorMessage": null,
"transactionId": null,
"authToken": eyJhbGciOiJIUzUxMiJ9.eyJzdLIiDMyQTVGNDlGNzQwNCIsImlhNjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrP64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA
}
}
url =
"https://cpaas.messagecentral.com/verification/v2/verification/validateOtp?countryCode=XX&mobileNumber=999XXXX875&verificationId=XX&customerId=CXC01XXXXAF1B94F0&code=XXXX"
payload = {}
headers = {
'authToken': 'eyJhbGciOiJIUzUxMiJ9.eyJzdLIiOyQTVGNDlGNzQwNCIsImlhdCI6MTY5NjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrPAFpxEanHkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP5mFvLQzI__uaA'}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
"responseCode": 200,
"message": "SUCCESS",
"data": {
"verificationId": "20",
"mobileNumber": "8846735392",
"verificationStatus": "VERIFICATION_COMPLETED",
"responseCode": "200",
"errorMessage": null,
"transactionId": null,
"authToken": eyJhbGciOiJIUzUxMiJ9.eyJzdLIiDMyQTVGNDlGNzQwNCIsImlhNjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrP64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA
}
}
require "net/http"
url = URI("https://cpaas.messagecentral.com/verification/v2/verification/validateOtp?countryCode=XX&mobileNumber=999XXXX875&verificationId=XX&customerId=CXC015XXXXF1B94F0&code=XXXX")
http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["authToken"] = "eyJhbGciOiJIUzUxMiJ9.eyJzdLIiOiMyQTVGNDlGNzQwNCIsImlhdCI6MTY5NjMxNDXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INAFpxEanH64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NmFvLQzI__uaA"
response = http.request(request)
puts response.read_body
"responseCode": 200,
"message": "SUCCESS",
"data": {
"verificationId": "20",
"mobileNumber": "8846735392",
"verificationStatus": "VERIFICATION_COMPLETED",
"responseCode": "200",
"errorMessage": null,
"transactionId": null,
"authToken": eyJhbGciOiJIUzUxMiJ9.eyJzdLIiDMyQTVGNDlGNzQwNCIsImlhNjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrP64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA
}
}
var request = new HttpRequestMessage(HttpMethod.Get, "https://cpaas.messagecentral.com/verification/v2/verification/validateOtp?countryCode=XX&mobileNumber=999XXXX875&verificationId=XX&customerId=CXC0XXXXAF1B94F0&code=XXXX");
request.Headers.Add("authToken", "eyJhbGciOiJIUzUxMiJ9.eyJzdLIiDMyQTVGNDlGNzQwNCIsImlhNjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrP64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
"responseCode": 200,
"message": "SUCCESS",
"data": {
"verificationId": "20",
"mobileNumber": "8846735392",
"verificationStatus": "VERIFICATION_COMPLETED",
"responseCode": "200",
"errorMessage": null,
"transactionId": null,
"authToken": eyJhbGciOiJIUzUxMiJ9.eyJzdLIiDMyQTVGNDlGNzQwNCIsImlhNjMxNDQzNiwiZXhwIjoxNjk2OTE5MjM2fQ.UDSi6Mpjr5INVGm4SRFrP64AD6JkiAv2zIReANR6pgmGEoo-T4AXXmgpqXjP56NYh6mFvLQzI__uaA
}
}