List Batches
curl --request GET \
--url https://api.bland.ai/v2/batches/list \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/batches/list"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v2/batches/list', 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/v2/batches/list",
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>"
],
]);
$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/v2/batches/list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
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/v2/batches/list")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/batches/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "652ad643-9gca-477c-97c3-9d8e6t74d7af",
"user_id": "64602f94-d670-43d2-8474-bcdcb9522c4f",
"base_prompt": "{\"record\":true,\"task\":\"Say hello to the user\"}",
"created_at": "2025-05-08T19:28:12.627Z",
"call_objects": [
{
"task": "Say hello to the user",
"phone_number": "+1234567890"
}
],
"description": "My first batch"
}
],
"errors": null
}
Batches
List Batches
Retrieve a list of all batches created by your organization.
GET
/
v2
/
batches
/
list
List Batches
curl --request GET \
--url https://api.bland.ai/v2/batches/list \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/batches/list"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v2/batches/list', 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/v2/batches/list",
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>"
],
]);
$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/v2/batches/list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
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/v2/batches/list")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/batches/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "652ad643-9gca-477c-97c3-9d8e6t74d7af",
"user_id": "64602f94-d670-43d2-8474-bcdcb9522c4f",
"base_prompt": "{\"record\":true,\"task\":\"Say hello to the user\"}",
"created_at": "2025-05-08T19:28:12.627Z",
"call_objects": [
{
"task": "Say hello to the user",
"phone_number": "+1234567890"
}
],
"description": "My first batch"
}
],
"errors": null
}
Headers
string
required
Your API key for authentication.
Query Parameters
integer
Optional. The number of results to return.
integer
Optional. The number of results to skip (used for pagination).
Response
array
A list of batches created by your organization.
string
The unique identifier of the batch.
string
The ID of the org that created the batch.
string
A JSON string representing the global call properties used in the batch.
string (ISO 8601)
The timestamp when the batch was created.
array
A preview of the call objects included in the batch.
string
A human-readable description of the batch.
null
Always
null on success.{
"data": [
{
"id": "652ad643-9gca-477c-97c3-9d8e6t74d7af",
"user_id": "64602f94-d670-43d2-8474-bcdcb9522c4f",
"base_prompt": "{\"record\":true,\"task\":\"Say hello to the user\"}",
"created_at": "2025-05-08T19:28:12.627Z",
"call_objects": [
{
"task": "Say hello to the user",
"phone_number": "+1234567890"
}
],
"description": "My first batch"
}
],
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I