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
Your API key for authentication.
Query Parameters
Number of results to return. Between 1 and 100.
Cursor: return results after this object ID.
Cursor: return results before this object ID. Cannot be combined with
starting_after.Response
Always
list.Array of user template summary objects.
Show user template object
Show user template object
Unique identifier (UUID) for the template.
Short key used to reference the template.
Display name of the template.
Description of the template, or
null.Category of the template, or
null.Evaluation modality. Either
text or audio.Who can access this template. One of
private, org, or public.Number of scoring levels defined on this template.
UUID of the eval agent this template was snapshotted from, or
null.UUID of the user who created the template, or
null.ISO 8601 timestamp of when the template was created.
ISO 8601 timestamp of when the template was last updated.
Whether additional results exist beyond this page.
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