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

> List flags on an issue.

## Overview

Returns the flags filed on this issue. Same shape as [Add Flag](https://docs.bland.ai/api-v1/post/triage-issues-id-flags.md).

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Path Parameters

**id** `string` *required*

Internal UUID of the issue.

***

## Query Parameters

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

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

**cursor** `string`

Opaque cursor returned as `next_cursor` from a previous page.

***

## Response

**data.items** `array`

Array of flags. See [Add Flag](https://docs.bland.ai/api-v1/post/triage-issues-id-flags.md#response) for the field list.

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

Cursor for the next page, or `null`.

**errors** `null | array`

`null` on success. Returns 404 if the issue does not exist.

```json Response theme={null}
{
  "data": {
    "items": [
      {
        "id": "8ce11a7a-1a30-4c2c-9d3a-3e9aa56d2f02",
        "org_id": "5fa6dc9e-ec4d-4f94-9e0e-21f6f6a1e8f1",
        "issue_id": "cd4e1b6a-9a4c-4ec7-9c91-aa8b8aef0c89",
        "call_id": "02d77f64-342d-4c41-b2f6-02621eb94fc3",
        "type": "missed_handoff",
        "note": "Agent transferred without confirming the email.",
        "node_id": null,
        "node_name": null,
        "message_index": 12,
        "message_text": "OK, transferring you now.",
        "author_id": "32c10b62-0a4e-4ad8-bd4e-9b6e2a6e0a4f",
        "created_at": "2026-05-07T05:26:11.327Z"
      }
    ],
    "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.