> ## 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, such as a drop in approval rate.

# 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](/docs/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

Returns up to 50 alerts with `status: "active"`, newest first. Dismissed and actioned alerts are excluded, so `dismissedAt` and `dismissedBy` are always `null` here.

Each alert includes its `alertType`, `severity` (`high`, `medium`, or `low`), a `title` and `description`, supporting `evidence`, an optional `suggestedAction` and `actionUrl`. Most alerts also carry a `dedupKey` that names the trend the alert tracks, such as `anomaly:approvalRate`.

`alertType` is one of `anomaly`, `configuration_drift`, `emerging_standard`, or `standards_drift`. The specific trend is named by `evidence.metric`: `approvalRate`, `volume`, `staleReferences`, `enforcementRate`, or `violationRate`. Depending on the alert, `evidence` also carries `baseline`, `current`, `window`, `sourceRecordIds`, `knowledgeSourceId`, and `ruleRef`.

#### Success Response

```JSON theme={null}
{
  "result": [
    {
      "id": "alert_1",
      "apiKey": "ak_live_...",
      "alertType": "anomaly",
      "severity": "medium",
      "title": "Approval rate dropped significantly",
      "description": "Approval rate fell from 72% (30-day) to 45% (7-day), a 27% drop.",
      "evidence": {
        "metric": "approvalRate",
        "baseline": 0.72,
        "current": 0.45,
        "window": "7d vs 30d"
      },
      "suggestedAction": "Review recent rejections to identify if a new pattern or reviewer behavior is causing the decline.",
      "actionUrl": null,
      "status": "active",
      "createdAt": 1731432000000,
      "dismissedAt": null,
      "dismissedBy": null,
      "dedupKey": "anomaly:approvalRate"
    }
  ]
}
```

#### Failure Response

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

<ResponseExample>
  ```js theme={null}
  {
    "result": [
      {
        "id": "alert_1",
        "apiKey": "ak_live_...",
        "alertType": "anomaly",
        "severity": "medium",
        "title": "Approval rate dropped significantly",
        "description": "Approval rate fell from 72% (30-day) to 45% (7-day), a 27% drop.",
        "evidence": {
          "metric": "approvalRate",
          "baseline": 0.72,
          "current": 0.45,
          "window": "7d vs 30d"
        },
        "suggestedAction": "Review recent rejections to identify if a new pattern or reviewer behavior is causing the decline.",
        "actionUrl": null,
        "status": "active",
        "createdAt": 1731432000000,
        "dismissedAt": null,
        "dismissedBy": null,
        "dedupKey": "anomaly:approvalRate"
      }
    ]
  }
  ```
</ResponseExample>