> ## 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 Flag Types

> List reusable flag types in your org.

## Overview

Catalog of flag types your org has used, with usage counts and the most recent note for each. Use it to render a flag-type picker. Types are normalized to lower\_snake\_case before storage.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Query Parameters

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

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

**cursor** `string`

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

***

## Response

**data.items** `array`

Array of flag types.

**Flag type fields**

**type** `string`

The normalized flag type (lower\_snake\_case).

**description** `string`

The note from the most recently filed flag of this type. Empty string if none of the flags carried a note.

**usage\_count** `number`

How many flags of this type currently exist in your org.

**last\_used\_at** `string | null`

ISO 8601 timestamp of the most recent flag of this type.

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

Cursor for the next page, or `null`.

**errors** `null | array`

`null` on success.

```json Response theme={null}
{
  "data": {
    "items": [
      {
        "type": "missed_handoff",
        "description": "Agent transferred without confirming the email.",
        "usage_count": 4,
        "last_used_at": "2026-05-07T05:26:11.327Z"
      },
      {
        "type": "wrong_pathway_node",
        "description": "Agent jumped to closing without verifying.",
        "usage_count": 2,
        "last_used_at": "2026-05-05T22:14:01.117Z"
      }
    ],
    "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.