---
title: "Account alert inbox."
method: GET
path: "/alerts"
tags: ["Layer 3 — Drift"]
---

# Account alert inbox.

`GET /alerts`

## Request

- Base URL: `https://entidex.com/api/v1`
- URL: `https://entidex.com/api/v1/alerts`
- Auth: HTTP bearer

## Response `200`

OK

- object
  - `data` Alert[]
    - `id` string, required
    - `subscriptionId` string, required
    - `driftEventId` string, required
    - `entityId` string, required
    - `deliveredAt` string, date-time, required
    - `deliveryChannel` 'webhook' | 'email' | 'slack' | 'none', required
    - `deliveryStatus` 'pending' | 'delivered' | 'failed' | 'retrying', required
    - `deliveryAttempts` integer, required
    - `acknowledgedAt` string, date-time, nullable
    - `driftEvent` DriftEvent, required
      - `id` string, required
      - `entityId` string, required
      - `type` 'sentiment_spike' | 'compounding_sentiment' | 'source_divergence' | 'fact_drift' | 'velocity_change' | 'neighbourhood_shift' | 'trust_stack_change' | 'ai_engine_drift' | 'surface_divergence_trend', required
      - `pattern` 'breakout' | 'erosion' | 'pivot' | 'crisis' | 'drift_to_irrelevance' | 'authority_lag'
      - `severity` 'low' | 'moderate' | 'high' | 'critical', required
      - `direction` 'positive' | 'negative' | 'neutral', required
      - `detectedAt` string, date-time, required
      - `windowStart` string, date-time, required
      - `windowEnd` string, date-time, required
      - `confidence` number, required
      - `signals` DriftSignal[], required
        - `surface` string, required
        - `metric` string, required
        - `value` unknown, required
        - `baseline` number, nullable
        - `zScore` number, nullable
        - `observationCount` integer, required
      - `explanation` string, required
      - `relatedClaimChanges` string[]
      - `projectedTrajectory` object, nullable
  - `meta` ResponseMeta
    - `requestId` string, required
    - `timestamp` string, date-time, required
    - `apiVersion` string, required
    - `pagination` object
      - `cursor` string, nullable
      - `hasMore` boolean
      - `limit` integer
    - `rateLimit` object
      - `limit` integer
      - `remaining` integer
      - `resetAt` string, date-time
    - `billing` object
      - `creditsUsed` integer
      - `creditsRemaining` integer, nullable
      - `tier` 'free' | 'layer_0_discovery' | 'layer_1_profile' | 'layer_2_insight' | 'layer_3_drift' | 'layer_4_cohort'
      - `allowedLayers` integer[]: Cumulative layer ladder unlocked by this key (0=discovery … 4=cohort). free → []; layer_2_insight → [0,1,2].
      - `mode` 'demo' | 'free' | 'payg' | 'keyed': How the caller is billed: demo (feedback-loop key), free (monthly allowance), payg (Developer PAYG), keyed (paid subscription).
  - `errors` ApiError[]
    - `code` 'ENTITY_NOT_RESOLVED' | 'ENTITY_NOT_FOUND' | 'INVALID_PARAMETER' | 'RATE_LIMITED' | 'INSUFFICIENT_CREDITS' | 'TIER_NOT_AVAILABLE' | 'UNAUTHENTICATED' | 'FORBIDDEN' | 'INTERNAL_ERROR', required
    - `message` string, required
    - `field` string
    - `candidates` object[]

---

[API](https://skmtc.dev/entidex/apis/entidex-api.md) · [All operations](https://skmtc.dev/entidex/apis/entidex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/entidex/apis/entidex-api/revisions/86b92f21a09a?raw)