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

# List Flags

> Get wellbeing flags for the current user

<Note>This endpoint requires authentication.</Note>

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `active` or `resolved`
</ParamField>

## Response

Array of flags.

<ResponseField name="data" type="array">
  <Expandable title="Flag object">
    <ResponseField name="id" type="string">
      Flag UUID
    </ResponseField>

    <ResponseField name="severity" type="string">
      Severity level: `low`, `medium`, `high`, `critical`
    </ResponseField>

    <ResponseField name="status" type="string">
      Current status: `active` or `resolved`
    </ResponseField>

    <ResponseField name="reason" type="string">
      General reason for the flag
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      When the flag was raised
    </ResponseField>

    <ResponseField name="resolvedAt" type="string">
      When resolved (if applicable)
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.hitler.app/api/flags?status=active" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```typescript TypeScript theme={null}
  const flags = await api.getFlags({ status: "active" });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "flag-uuid-123",
      "severity": "medium",
      "status": "active",
      "reason": "Declining mood trend over past 2 weeks",
      "userId": "user-uuid",
      "organizationId": "org-uuid",
      "createdAt": "2024-01-15T00:00:00.000Z",
      "resolvedAt": null
    }
  ]
  ```
</ResponseExample>