Latest Legacy

Retrieve a queued call

This method lets you retrieve details of a specific queued call. The maximum number of results that you can fetch with a single API call is 20.

API Endpoint

GET https://api.plivo.com/v1/Account/{auth_id}/Call/{call_uuid}/?status=queued

Arguments

No arguments need to be passed.

Returns

Returns the call objects that match the filters specified in the request.

Response

{
  "direction": "outbound",
  "from": "15856338537",
  "call_status": "queued",
  "api_id": "45223222-74f8-11e1-8ea7-12313806be9a",
  "to": "14154290945",
  "caller_name": "+15856338537",
  "call_uuid": "6653422-91b6-4716-9fad-9463daaeeec2",
  "request_uuid": "6653422-91b6-4716-9fad-9463daaeeec2"
}

Example Request

1
2
3
4
5
6
import plivo

client = plivo.RestClient('<auth_id>','<auth_token>')

response = client.queued_calls.get('10f0cb68-7533-45ed-acb5-87ceac29ee48')
print(response)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
#
# Example for QueuedCall Get
#
require 'rubygems'
require 'plivo'

	include Plivo
	include Plivo::Exceptions

	api = RestClient.new("<auth_id>","<auth_token>")

	begin
			response = api.calls.get_queued(
  			'd6b00702-f7e2-49c9-9a90-5921c6602788'
			)
			puts response
	rescue PlivoRESTError => e
			puts 'Exception: ' + e.message
	end
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// Example for QueuedCall get

var plivo = require('plivo');

		(function main() {
    			'use strict';

    		// As the auth_id and auth_token are unspecified, Plivo will fetch them from the PLIVO_AUTH_ID and PLIVO_AUTH_TOKEN environment variables.
    			var client = new plivo.Client("<auth_id>","<auth_token>");
    			client.calls.getQueuedCall(
       			 "d6b00702-f7e2-49c9-9a90-5921c6602788", // call uuid
    			).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
16
17
<?php
/**
 * Example for QueuedCall get
 */
require 'vendor/autoload.php';
		use Plivo\RestClient;
		use Plivo\Exceptions\PlivoRestException;
		$client = new RestClient("<auth_id>","<auth_token>");
		try {
   			$response = $client->calls->getQueued(
       			'd6b00702-f7e2-49c9-9a90-5921c6602788'
   			);
   			print_r($response);
		}
		catch (PlivoRestException $ex) {
   			print_r($ex);
		}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
package com.plivo.api.samples.livecall;

	import java.io.IOException;
	import com.plivo.api.Plivo;
	import com.plivo.api.exceptions.PlivoRestException;
	import com.plivo.api.models.call.LiveCall;

	/**
	 * Example for QueuedCall get
 	*/
	class QueuedCallGet {
    		public static void main(String [] args) {
        		Plivo.init("<auth_id>","<auth_token>");
        		try {
            		QueuedCall response = QueuedCall.getter("eba53b9e-8fbd-45c1-9444-696d2172fbc8")
                    		.get();

            		System.out.println(response);
        		} catch (PlivoRestException | IOException 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
26
27
28
/**
 * Example for QueuedCall get
 */
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.Call.GetQueued("d6b00702-f7e2-49c9-9a90-5921c6602788"
                );
                Console.WriteLine(response);
            }
            catch (PlivoRestException e)
            {
                Console.WriteLine("Exception: " + e.Message);
            }
        }
    }
}
1
2
curl -i --user AUTH_ID:AUTH_TOKEN \
   https://api.plivo.com/v1/Account/{auth_id}/Call/{call_uuid}/?status=queued/
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// Example for QueuedCall get
package main

	import "fmt"
	import "github.com/plivo/plivo-go/v7"

	func main() {
	client, err := plivo.NewClient("<auth_id>","<auth_token>", &plivo.ClientOptions{})
	if err != nil {
			fmt.Print("Error", err.Error())
			return
		}
	response, err := client.QueuedCalls.Get
(
		"d6b00702-f7e2-49c9-9a90-5921c6602788",
	)
	if err != nil {
			fmt.Print("Error", err.Error())
			return
		}
	fmt.Printf("Response: %#v\n", response)
}