Latest Legacy

Retrieve details of a verified caller ID

The method lets you retrieve details of a verified caller ID.

API Endpoint

GET https://api.plivo.com/v1/Account/{auth_id}/VerifiedCallerId/{phone_number}

Attributes

No arguments need to be passed.

Response

{
  "alias": "US Mainland",
  "api_id": "79ba7d96-94bb-4b91-a288-419213fa9239",
  "country": "US",
  "created_at": "2024-02-09T03:52:22.880098Z",
  "modified_at": "2024-02-09T03:52:22.880098Z",
  "phone_number": "+12025551XXX",
  "subaccount": "",
  "verification_uuid": "f87836bd-f3c0-41bb-9498-125e6faaa4d4"
}

Example Request

1
2
3
4
5
6
7
import plivo

client = plivo.RestClient('<Auth>', '<Token>')

resonse = client.verify_callerids.get_verified_caller_id("+91XXXXXXXXXX")

print(response)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
require 'rubygems'
require 'plivo'

include Plivo
include Plivo::Exceptions


api = RestClient.new("<auth>", "<token>")
begin
  response = api.verify_caller_id.get("+918149002252")
    puts response
rescue PlivoRESTError => e
  puts 'Exception: ' + e.message
  
end
1
2
3
4
5
6
7
8
9
10
11
12
13
var plivo = require('plivo');

(function main() {
    'use strict';
    
    var client = new plivo.Client("<auth_id>","<auth_token>");
	client.verify.getVerifiedCallerId('<verified_phone_number>').then(function(response) {
            console.log(response)
        }, function (err) {
                console.error(err);
            });

})();
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<?php
/**
 * Example for Retrieve details of a verified caller ID
 */
require 'vendor/autoload.php';
use Plivo\RestClient;
use Plivo\Exceptions\PlivoRestException;
$client = new RestClient("<auth>","<token>");

    try {
        $response = $client->verifyCallerId->getVerifiedCallerId("+91XXXXXXXXXX");
    }
    catch (PlivoRestException $ex) {
    print_r($ex);
    } 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
package com.plivo.examples;

import com.plivo.api.Plivo;
import com.plivo.api.models.verify.ListVerifiedCallerId;
import com.plivo.api.models.verify.Verify;

public class verificationCallerID {

  public static void main(String[] args) {
    Plivo.init("<auth>", "<token>");
      try {
	    GetVerifiedCallerId response = Verify.getVerifiedCallerID("+919268368720");
            System.out.println(response);
      }catch (Exception e){
        e.printStackTrace();
      }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
using System;
using System.Collections.Generic;
using Plivo;
using Plivo.Exception;

namespace PlivoExamples
{
    internal class Program
    {
        public static void Main(string[] args)
        {
            var api = new PlivoApi("<auth-id>","<auth-token>");
            try
            {
                var response = api.VerifyCallerId.Get("<phone_number>");
                Console.WriteLine(response);
            }
            catch (PlivoRestException e)
            {
                Console.WriteLine("Exception: " + e.Message);
                Console.WriteLine("Exception: " + e);
            }
        }
    }
}
1
2
 curl -i --user AUTH_ID:AUTH_TOKEN \
    https://api.plivo.com/v1/Account/{auth_id}/VerifiedCallerId/{phone_number}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
package main
import (
	"fmt"
	"github.com/plivo/plivo-go/v7"
)

func main() {
	client, err := plivo.NewClient("<Auth>", "<Token>", &plivo.ClientOptions{})
	if err != nil {
		fmt.Print("Error", err.Error())
		return
	}
	response, err := client.VerifyCallerId.GetVerifiedCallerID("<phone_number>")

	if err != nil {
		fmt.Print("Error", err.Error())
		return
	}
	fmt.Printf("Response: %#v\n", response)