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

# List alert statuses

> List all custom alert statuses for your organization and the allowed colour codes.

List all custom alert statuses for your organization and the allowed colour codes. Use this to build status pickers and show name/colour for each status.

***

### Response structure

<ResponseExample>
  ```json Success theme={"system"}
  {
    "data": [
      {
        "organization_id": "org_01ABC123",
        "key": "PENDING_REVIEW",
        "name": "Pending Review",
        "colour": "#3B82F6",
        "created_at": "2025-01-29T14:00:00Z",
        "updated_at": "2025-01-29T14:00:00Z"
      }
    ],
    "allowed_colours": [
      "#3B82F6", "#10B981", "#F59E0B", "#EF4444", "#8B5CF6",
      "#EC4899", "#06B6D4", "#84CC16", "#F97316", "#6366F1",
      "#14B8A6", "#A855F7", "#E11D48", "#64748B", "#0EA5E9"
    ]
  }
  ```
</ResponseExample>

<ResponseField name="data" type="array" required>
  Array of custom status objects for the organization.
</ResponseField>

<ResponseField name="allowed_colours" type="array" required>
  List of hex colour codes allowed when creating or updating a status.
</ResponseField>

<Expandable title="Status object properties">
  <ResponseField name="organization_id" type="string" required>
    Organization ID that owns the status.
  </ResponseField>

  <ResponseField name="key" type="string" required>
    Unique key for the status (e.g. PENDING\_REVIEW). Used when setting an alert's status and in update/delete URLs.
  </ResponseField>

  <ResponseField name="name" type="string" required>
    Display name for the status.
  </ResponseField>

  <ResponseField name="colour" type="string" required>
    Hex colour code for the status (one of allowed\_colours).
  </ResponseField>

  <ResponseField name="created_at" type="timestamp" required>
    ISO 8601 timestamp when the status was created.
  </ResponseField>

  <ResponseField name="updated_at" type="timestamp" required>
    ISO 8601 timestamp when the status was last updated.
  </ResponseField>
</Expandable>

***

## Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.

To ask questions or discuss issues, please [contact us](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).

**Need help with your product?**

Get dedicated support for architecture reviews, integration planning, ledger workflows, and production deployment.