Skip to main content
GET
/
v1
/
evals
/
user-templates
List User Templates
curl --request GET \
  --url https://api.bland.ai/v1/evals/user-templates \
  --header 'authorization: <authorization>'
{
  "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

​
authorization
string
required
Your API key for authentication.

​
Query Parameters

​
limit
integer
default:"25"
Number of results to return. Between 1 and 100.
​
starting_after
string
Cursor: return results after this object ID.
​
ending_before
string
Cursor: return results before this object ID. Cannot be combined with starting_after.

​
Response

​
object
string
Always list.
​
data
array
Array of user template summary objects.
​
has_more
boolean
Whether additional results exist beyond this page.
​
next_cursor
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