List User Templates
curl --request GET \
--url https://api.bland.ai/v1/evals/user-templates \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/evals/user-templates"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/evals/user-templates', 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/evals/user-templates",
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/v1/evals/user-templates"
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/v1/evals/user-templates")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/evals/user-templates")
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": {
"object": "list",
"data": [
{
"id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
"key": "my_hallucination_check",
"name": "My Hallucination Check",
"description": "Customized hallucination detection for our product domain.",
"category": "quality",
"modality": "text",
"visibility": "org",
"level_count": 3,
"source_agent_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-01T10:00:00.000Z",
"updated_at": "2026-05-10T14:30:00.000Z"
},
{
"id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
"key": "sales_compliance_v2",
"name": "Sales Compliance v2",
"description": null,
"category": "compliance",
"modality": "audio",
"visibility": "private",
"level_count": 2,
"source_agent_id": null,
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-15T08:00:00.000Z",
"updated_at": "2026-05-15T08:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
},
"errors": null
}
Templates
List User Templates
List your organization’s saved eval agent templates.
GET
/
v1
/
evals
/
user-templates
List User Templates
curl --request GET \
--url https://api.bland.ai/v1/evals/user-templates \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/evals/user-templates"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/evals/user-templates', 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/evals/user-templates",
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/v1/evals/user-templates"
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/v1/evals/user-templates")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/evals/user-templates")
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": {
"object": "list",
"data": [
{
"id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
"key": "my_hallucination_check",
"name": "My Hallucination Check",
"description": "Customized hallucination detection for our product domain.",
"category": "quality",
"modality": "text",
"visibility": "org",
"level_count": 3,
"source_agent_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-01T10:00:00.000Z",
"updated_at": "2026-05-10T14:30:00.000Z"
},
{
"id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
"key": "sales_compliance_v2",
"name": "Sales Compliance v2",
"description": null,
"category": "compliance",
"modality": "audio",
"visibility": "private",
"level_count": 2,
"source_agent_id": null,
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-15T08:00:00.000Z",
"updated_at": "2026-05-15T08:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
},
"errors": null
}
Headers
string
required
Your API key for authentication.
Query Parameters
integer
default:"25"
Number of results to return. Between 1 and 100.
string
Cursor: return results after this object ID.
string
Cursor: return results before this object ID. Cannot be combined with
starting_after.Response
string
Always
list.array
Array of user template summary objects.
Show user template object
Show user template object
string
Unique identifier (UUID) for the template.
string
Short key used to reference the template.
string
Display name of the template.
string
Description of the template, or
null.string
Category of the template, or
null.string
Evaluation modality. Either
text or audio.string
Who can access this template. One of
private, org, or public.integer
Number of scoring levels defined on this template.
string
UUID of the eval agent this template was snapshotted from, or
null.string
UUID of the user who created the template, or
null.string
ISO 8601 timestamp of when the template was created.
string
ISO 8601 timestamp of when the template was last updated.
boolean
Whether additional results exist beyond this page.
string
Cursor to pass as
starting_after to fetch the next page, or null when there are no more results.{
"data": {
"object": "list",
"data": [
{
"id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
"key": "my_hallucination_check",
"name": "My Hallucination Check",
"description": "Customized hallucination detection for our product domain.",
"category": "quality",
"modality": "text",
"visibility": "org",
"level_count": 3,
"source_agent_id": "b2c3d4e5-6789-abcd-ef01-234567890abc",
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-01T10:00:00.000Z",
"updated_at": "2026-05-10T14:30:00.000Z"
},
{
"id": "d4e5f6a7-89ab-cdef-0123-4567890abcde",
"key": "sales_compliance_v2",
"name": "Sales Compliance v2",
"description": null,
"category": "compliance",
"modality": "audio",
"visibility": "private",
"level_count": 2,
"source_agent_id": null,
"created_by": "9a8b7c6d-5e4f-3210-9876-543210fedcba",
"created_at": "2026-05-15T08:00:00.000Z",
"updated_at": "2026-05-15T08:00:00.000Z"
}
],
"has_more": false,
"next_cursor": null
},
"errors": null
}
Docs for agents: llms.txt
Was this page helpful?
⌘I