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

> List issue categories.

## Overview

Returns the org's category catalog. Built-in defaults (Transcription, Speech, Dialogue, Routing, Tools, Latency, Telephony, Bug) use IDs like `built-in:<name>`. Custom categories created with [Create Category](https://docs.bland.ai/api-v1/post/triage-categories.md) use a UUID. Sorted alphabetically, so `next_cursor` is the name of the last item.

Issue `category` is free-form on creation, this catalog is just used for autocomplete and faceted filters in the dashboard.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Query Parameters

**limit** `integer` (default: 50)

Number of categories to return. Minimum 1, maximum 100.

**cursor** `string`

Opaque cursor returned as `next_cursor` from a previous page. For categories, this is the name of the last item from the previous page.

***

## Response

**data.items** `array`

Array of categories.

**Category fields**

**id** `string`

`built-in:<name>` for default categories, UUID for custom categories.

**org\_id** `string`

**name** `string`

Display name. 1-64 characters.

**created\_at** `string`

**data.next\_cursor** `string | null`

Cursor for the next page, or `null`.

**errors** `null | array`

`null` on success.

```json Response theme={null}
{
  "data": {
    "items": [
      {
        "id": "built-in:bug",
        "org_id": "5fa6dc9e-ec4d-4f94-9e0e-21f6f6a1e8f1",
        "name": "Bug",
        "created_at": "2026-05-07T05:25:56.034Z"
      },
      {
        "id": "built-in:dialogue",
        "org_id": "5fa6dc9e-ec4d-4f94-9e0e-21f6f6a1e8f1",
        "name": "Dialogue",
        "created_at": "2026-05-07T05:26:21.855Z"
      },
      {
        "id": "built-in:latency",
        "org_id": "5fa6dc9e-ec4d-4f94-9e0e-21f6f6a1e8f1",
        "name": "Latency",
        "created_at": "2026-05-07T05:26:21.855Z"
      }
    ],
    "next_cursor": "Latency"
  },
  "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.