> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List User Templates

> List your organization's saved eval agent templates.

### 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.

**user template object**

**id** `string`

Unique identifier (UUID) for the template.

**key** `string`

Short key used to reference the template.

**name** `string`

Display name of the template.

**description** `string`

Description of the template, or `null`.

**category** `string`

Category of the template, or `null`.

**modality** `string`

Evaluation modality. Either `text` or `audio`.

**visibility** `string`

Who can access this template. One of `private`, `org`, or `public`.

**level\_count** `integer`

Number of scoring levels defined on this template.

**source\_agent\_id** `string`

UUID of the eval agent this template was snapshotted from, or `null`.

**created\_by** `string`

UUID of the user who created the template, or `null`.

**created\_at** `string`

ISO 8601 timestamp of when the template was created.

**updated\_at** `string`

ISO 8601 timestamp of when the template was last updated.

**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.

```json Response theme={null}
{
  "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](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.