Get Batch
curl --request GET \
--url https://api.bland.ai/v2/batches/{batch_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/batches/{batch_id}"
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/{batch_id}', 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/{batch_id}",
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/{batch_id}"
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/{batch_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/batches/{batch_id}")
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": "a9a033b7-44d8-40c6-aaec-42cd43106273",
"user_id": "657ad643-92ca-477c-97cc-9d8e6e74d7af",
"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": "Untitled Batch"
},
"errors": null
}
Batches
Get Batch
Retrieve metadata for a specific batch. This does not include logs, use the logs endpoint for that.
GET
/
v2
/
batches
/
{batch_id}
Get Batch
curl --request GET \
--url https://api.bland.ai/v2/batches/{batch_id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v2/batches/{batch_id}"
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/{batch_id}', 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/{batch_id}",
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/{batch_id}"
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/{batch_id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v2/batches/{batch_id}")
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": "a9a033b7-44d8-40c6-aaec-42cd43106273",
"user_id": "657ad643-92ca-477c-97cc-9d8e6e74d7af",
"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": "Untitled Batch"
},
"errors": null
}
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
The unique identifier of the batch you want to fetch.
Response
object
Metadata and configuration details of the batch.
string
The unique identifier of the batch.
string
The ID of the org that created the batch.
string
A JSON string representing shared call properties such as
task or record.string (ISO 8601)
The timestamp of when the batch was created.
array
A preview of call objects in the batch.
string
A human-readable label or description for the batch.
null
Always
null on success.{
"data": {
"id": "a9a033b7-44d8-40c6-aaec-42cd43106273",
"user_id": "657ad643-92ca-477c-97cc-9d8e6e74d7af",
"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": "Untitled Batch"
},
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I