Calls
List Active Calls
Retrieve all currently active calls for your organization. Active calls include both queued and in-progress calls that have not yet completed.
GET
/
v1
/
calls
/
active
List Active Calls
curl --request GET \
--url https://api.bland.ai/v1/calls/active \
--header 'authorization: <authorization>' \
--header 'x-bland-org-id: <x-bland-org-id>'import requests
url = "https://api.bland.ai/v1/calls/active"
headers = {
"authorization": "<authorization>",
"x-bland-org-id": "<x-bland-org-id>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {authorization: '<authorization>', 'x-bland-org-id': '<x-bland-org-id>'}
};
fetch('https://api.bland.ai/v1/calls/active', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/calls/active",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"authorization: <authorization>",
"x-bland-org-id: <x-bland-org-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/calls/active"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("x-bland-org-id", "<x-bland-org-id>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/calls/active")
.header("authorization", "<authorization>")
.header("x-bland-org-id", "<x-bland-org-id>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/calls/active")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
request["x-bland-org-id"] = '<x-bland-org-id>'
response = http.request(request)
puts response.read_body{
"data": [
{
"call_id": "8dd6f762-6c67-4546-aaad-3e59f5e4a09c",
"user_id": "bdffa9e8-436c-416d-b95f-a77b19ae4411",
"from": "+18475586665",
"to": "+13105100966",
"objective": "You are a 2...",
"pathway_id": "",
"start_time": "",
"international": "false",
"status": "QUEUED",
"timestamp": "1758656817432",
"inbound": false,
"agent_id": null,
"started_at": null
},
{
"call_id": "dadbc09a-9b0b-4eb5-b67f-0c7f1206c623",
"user_id": "bdffa9e8-436c-416d-b95f-a77b19ae4411",
"from": "+18154728283",
"to": "+16106876633",
"objective": "You are a 2...",
"pathway_id": "",
"start_time": "",
"international": "false",
"status": "IN_PROGRESS",
"timestamp": "1758656900740",
"inbound": true,
"agent_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"started_at": "2025-09-23T19:48:21.512Z"
}
],
"errors": null
}
Headers
string
required
Your API key for authentication.
string
required
The unique organization ID.
Response
array
An array of active call objects. Each object represents one ongoing or queued call.
string
Unique identifier for the call.
string
The organization/user ID that initiated the call.
string
The originating phone number.
string
The destination phone number.
string
The agent prompt or objective that was used to initiate the call.
string
The pathway ID associated with the call, if any.
string
The call start time (ISO 8601 string). May be empty if the call has not started.
string
"true" if the call is international, "false" otherwise.boolean
true if the call is inbound to one of your numbers, false if it is outbound.string | null
The ID of the agent handling the call.
null if the call is not linked to an agent.string | null
When the call started (ISO 8601, UTC).
null if the call has not started yet.string
Current call status (e.g.,
QUEUED, IN_PROGRESS).string
Unix epoch (milliseconds) when the call record was created.
null
Always
null on success.{
"data": [
{
"call_id": "8dd6f762-6c67-4546-aaad-3e59f5e4a09c",
"user_id": "bdffa9e8-436c-416d-b95f-a77b19ae4411",
"from": "+18475586665",
"to": "+13105100966",
"objective": "You are a 2...",
"pathway_id": "",
"start_time": "",
"international": "false",
"status": "QUEUED",
"timestamp": "1758656817432",
"inbound": false,
"agent_id": null,
"started_at": null
},
{
"call_id": "dadbc09a-9b0b-4eb5-b67f-0c7f1206c623",
"user_id": "bdffa9e8-436c-416d-b95f-a77b19ae4411",
"from": "+18154728283",
"to": "+16106876633",
"objective": "You are a 2...",
"pathway_id": "",
"start_time": "",
"international": "false",
"status": "IN_PROGRESS",
"timestamp": "1758656900740",
"inbound": true,
"agent_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"started_at": "2025-09-23T19:48:21.512Z"
}
],
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
List Active Calls
curl --request GET \
--url https://api.bland.ai/v1/calls/active \
--header 'authorization: <authorization>' \
--header 'x-bland-org-id: <x-bland-org-id>'import requests
url = "https://api.bland.ai/v1/calls/active"
headers = {
"authorization": "<authorization>",
"x-bland-org-id": "<x-bland-org-id>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {authorization: '<authorization>', 'x-bland-org-id': '<x-bland-org-id>'}
};
fetch('https://api.bland.ai/v1/calls/active', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/calls/active",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"authorization: <authorization>",
"x-bland-org-id: <x-bland-org-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/calls/active"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("x-bland-org-id", "<x-bland-org-id>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/calls/active")
.header("authorization", "<authorization>")
.header("x-bland-org-id", "<x-bland-org-id>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/calls/active")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
request["x-bland-org-id"] = '<x-bland-org-id>'
response = http.request(request)
puts response.read_body{
"data": [
{
"call_id": "8dd6f762-6c67-4546-aaad-3e59f5e4a09c",
"user_id": "bdffa9e8-436c-416d-b95f-a77b19ae4411",
"from": "+18475586665",
"to": "+13105100966",
"objective": "You are a 2...",
"pathway_id": "",
"start_time": "",
"international": "false",
"status": "QUEUED",
"timestamp": "1758656817432",
"inbound": false,
"agent_id": null,
"started_at": null
},
{
"call_id": "dadbc09a-9b0b-4eb5-b67f-0c7f1206c623",
"user_id": "bdffa9e8-436c-416d-b95f-a77b19ae4411",
"from": "+18154728283",
"to": "+16106876633",
"objective": "You are a 2...",
"pathway_id": "",
"start_time": "",
"international": "false",
"status": "IN_PROGRESS",
"timestamp": "1758656900740",
"inbound": true,
"agent_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"started_at": "2025-09-23T19:48:21.512Z"
}
],
"errors": null
}