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

> List triage issues with filters and keyset pagination.

## Overview

Lists triage issues for your org. Items have the same shape as [Create Issue](https://docs.bland.ai/api-v1/post/triage-issues.md). The same filters power the [Triage dashboard](https://app.bland.ai/dashboard/monitor/triage) sidebar.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Query Parameters

### Pagination

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

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

**cursor** `string`

Opaque cursor returned as `next_cursor` from a previous page. Omit on the first request.

### Sorting

**sort** `string` (default: last\_activity\_at)

Field to sort by. Must be one of:

* `last_activity_at` (default)
* `created_at`
* `severity`
* `status`

All sorts include a stable secondary sort by `id` so keyset pagination is deterministic.

**order** `string` (default: desc)

Sort direction. `asc` or `desc`.

### Search

**search** `string`

Free-text search across issue title and description.

### Faceted filters

**status** `string | string[]`

Filter by status. Pass a single value, or repeat the parameter for multiple. Allowed values: `backlog`, `todo`, `in_progress`, `in_review`, `done`, `closed`.

```
?status=todo&status=in_progress
```

**severity** `string | string[]`

Filter by severity. Allowed values: `critical`, `high`, `medium`, `low`. Repeatable.

**category** `string | string[]`

Filter by category name. Repeatable.

**resource\_type** `string`

Only return issues that have at least one resource of this type. One of `call`, `sms_conversation`, `file`.

### Scope filters

**owner\_id** `string`

Only return issues with this owner.

**assignee\_id** `string`

Only return issues with this assignee.

### Date range

**date\_field** `string` (default: last\_activity\_at)

Which date field the `date_range` filter applies to. One of `last_activity_at` or `created_at`.

**date\_range** `string`

Relative window from now. One of:

* `24h`
* `7d`
* `30d`
* `90d`

***

## Response

**data.items** `array`

Array of issues. Each issue has the same shape as the response from [Create Issue](https://docs.bland.ai/api-v1/post/triage-issues.md).

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

Cursor to pass back as the `cursor` query parameter for the next page. `null` when there are no more pages.

**errors** `null | array`

`null` on success.

```json Response theme={null}
{
  "data": {
    "items": [
      {
        "id": "1aec670c-08d1-42dd-933b-b939508e6693",
        "triage_id": "T-1042",
        "org_id": "4edcdd57-4b33-4d1f-a905-e6859ed8cca9",
        "number": 1042,
        "title": "Agent skipped the verification step",
        "description": "On the Aug 12 demo flow the agent jumped to the closing node...",
        "status": "in_progress",
        "severity": "high",
        "source": "manual",
        "category": "Routing",
        "owner_id": null,
        "assignee_id": "6e6c4e2f-ec3f-4582-bd95-6fa2d6375234",
        "author_id": "4fa8878d-4091-4c19-849a-1c64a79609da",
        "external_link": null,
        "created_at": "2026-05-04T18:24:11.482Z",
        "updated_at": "2026-05-06T02:11:08.901Z",
        "last_activity_at": "2026-05-06T02:11:08.901Z",
        "resource_count": 3,
        "flag_count": 1,
        "relation_count": 0,
        "latest_agent_session": null,
        "is_processing": false,
        "has_unread_activity": true
      },
      {
        "id": "822508a1-4e77-498b-892a-01cf6f9b1801",
        "triage_id": "T-1039",
        "org_id": "4edcdd57-4b33-4d1f-a905-e6859ed8cca9",
        "number": 1039,
        "title": "Caller transferred to wrong queue",
        "description": "",
        "status": "todo",
        "severity": "high",
        "source": "automated",
        "category": "Routing",
        "owner_id": null,
        "assignee_id": null,
        "author_id": "4fa8878d-4091-4c19-849a-1c64a79609da",
        "external_link": null,
        "created_at": "2026-05-03T22:14:01.117Z",
        "updated_at": "2026-05-03T22:14:01.117Z",
        "last_activity_at": "2026-05-03T22:14:01.117Z",
        "resource_count": 1,
        "flag_count": 0,
        "relation_count": 0,
        "latest_agent_session": null,
        "is_processing": false,
        "has_unread_activity": false
      }
    ],
    "next_cursor": "822508a1-4e77-498b-892a-01cf6f9b1801"
  },
  "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.