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

# List Alerts

Use this API to list active Memory alerts (capped at 50). Alerts are proactive notifications about review trends, e.g. an approval-rate drift.

# Endpoint

`POST https://api.velt.dev/v2/memory/alerts/list`

# Headers

<ParamField header="x-velt-api-key" type="string" required>
  Your API key.
</ParamField>

<ParamField header="x-velt-auth-token" type="string" required>
  Your [Auth Token](/security/auth-tokens).
</ParamField>

# Body

#### Params

<ParamField body="data" type="object" required>
  No fields required. Send an empty object.
</ParamField>

## **Example Requests**

#### List active alerts

```JSON theme={null}
{
  "data": {}
}
```

# Response

Each alert includes its `alertType`, `severity` (`high`, `medium`, or `low`), a `title` and `description`, supporting `evidence`, an optional `suggestedAction` and `actionUrl`, its `status`, and dismissal metadata.

#### Success Response

```JSON theme={null}
{
  "result": [
    {
      "id": "alert_1",
      "apiKey": "ak_live_...",
      "alertType": "approval-rate-drift",
      "severity": "medium",
      "title": "Approval rate dropped 18% this week",
      "description": "...",
      "evidence": {},
      "suggestedAction": "Review recent rejections in Acme EU.",
      "actionUrl": null,
      "status": "active",
      "createdAt": 1731432000000,
      "dismissedAt": null,
      "dismissedBy": null
    }
  ]
}
```

#### Failure Response

```JSON theme={null}
{
  "error": {
    "message": "ERROR_MESSAGE",
    "status": "INVALID_ARGUMENT"
  }
}
```

<ResponseExample>
  ```js theme={null}
  {
    "result": [
      {
        "id": "alert_1",
        "apiKey": "ak_live_...",
        "alertType": "approval-rate-drift",
        "severity": "medium",
        "title": "Approval rate dropped 18% this week",
        "description": "...",
        "evidence": {},
        "suggestedAction": "Review recent rejections in Acme EU.",
        "actionUrl": null,
        "status": "active",
        "createdAt": 1731432000000,
        "dismissedAt": null,
        "dismissedBy": null
      }
    ]
  }
  ```
</ResponseExample>