Voice Call

The voice call API enables you to send messages from your application through our voice channel to a phone number. Only one-time-passwords (OTP) are allowed for now and these OTPs can not be verified using our Verify Token API.

Endpoint : https://BASE_URL/api/sms/otp/call

Request Type : POST

Options	Required	Description
api_key	yes	string Your API key (It can be found on your Termii dashboard).
phone_number	yes	string The destination phone number. Phone number must be in the international format (`Example: 23490126727`)
code	yes	numeric Example: `3344` The code you want your users to receive. It has to be numeric and length must be between 4 and 8 digits.

 {
     "api_key" : "Your API key",
     "phone_number" : "2349800000000",
     "code" : 55675,
    
 }

var data = {
             "api_key" : "Your API key",
             "phone_number" : "2349800000000",
             "code" : 55675
      };

var data = JSON.stringify(data);

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
  console.log(this.responseText);
}
});

xhr.open("POST", "https://BASE_URL/api/sms/otp/send/voice");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);

var request = require('request');
  var data = {
                 "api_key" : "Your API key",
                 "phone_number" : "2349800000000",
                 "code" : 55675
              };
  var options = {
    'method': 'POST',
    'url': 'https://BASE_URL/api/sms/otp/send/voice',
    'headers': {
      'Content-Type': ['application/json', 'application/json']
    },
    body: JSON.stringify(data)
  
  };
  request(options, function (error, response) { 
    if (error) throw new Error(error);
    console.log(response.body);
  });

import requests
url = "https://BASE_URL/api/sms/otp/send/voice"
payload = {
           "api_key" : "Your API key",
           "phone_number" : "2349800000000",
           "code" : 55675
       }
headers = {
'Content-Type': 'application/json',
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.text)

RestClient restClient = new RestClient("https://BASE_URL/api/sms/otp/send/voice");
  
  //Creating Json object
  JObject objectBody = new JObject();
  objectBody.Add("api_key","Your API Key");
  objectBody.Add("phone_number","+2348109077743");
  objectBody.Add("code", 55675)

  RestRequest restRequest = new RestRequest(Method.POST);
  
  restRequest.AddHeader("Content-Type", "application/json");
  restRequest.AddParameter("application/json", objectBody,  ParameterType.RequestBody);
  IRestResponse restResponse = restClient.Execute(restRequest);
  Console.WriteLine(restResponse.Content);  

Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://BASE_URL/api/sms/otp/send/voice")
.header("Content-Type", "application/json")
.body("{\n\n  \"api_key\" : \"Your API key\",\n    
       \"phone_number\" : \"2349800000000\",\n   
           \"code\" : 55675\n }")
.asString();

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
CURLOPT_URL => 'https://BASE_URL/api/sms/otp/send/voice',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 55675,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_POSTFIELDS =>'{

     "api_key" : "Your API key",
     "phone_number" : "2349800000000",
     "code" : 55675
}',
CURLOPT_HTTPHEADER => array(
  'Content-Type: application/json'
),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response

  {
     "code": "ok",
     "message_id": "453166532802459832",
     "pinId": "29ae67c2-c8e1-4165-8a51-8d3d7c298081",
     "message": "Successfully Sent",
     "balance": 77.5,
     "user": "Termii Test"
  }