Self-Exclusion

Real-time exclusion list with three-layer propagation (webhook + REST + nightly snapshot).

Anunnaki holds the master self-exclusion list and propagates it to operators in real time. The list is enforced via webhook push (sub-second), live REST check (signup / login / pre-deposit), and a daily 03:00 UTC bulk snapshot — three independent layers so an exclusion is never missed.

Supported durations

Type	API value	Reversible?
24-hour cool-off	duration_24h	Auto-expires
7-day short break	duration_7d	Auto-expires
30-day cool-off	duration_30d	Auto-expires
6-month time-out	duration_6m	Auto-expires
1-year long exclusion	duration_1y	Auto-expires
Permanent	duration_permanent	Irrevocable (KGC)

Endpoints

Method	Path	Description
POST	/v1/exclusions	Register a new exclusion. Idempotent on (user, duration).
GET	/v1/exclusions/check	Cross-tenant lookup by email or phone.
GET	/v1/exclusions/snapshot	Paginated full snapshot (for nightly reconciliation).

POST /v1/exclusions

curl https://sandbox.api.anunnakielite.com/v1/exclusions \
  -H "Authorization: Bearer cur_sk_test_EXAMPLEKEY123456789012345678901234" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "rt_usr_8a2f1c",
    "email": "[e-mail]",
    "phone": "[phone]",
    "duration": "duration_6m",
    "reason": "self_initiated",
    "initiated_at": "2026-05-24T14:32:00Z"
  }'

{
  "exclusion_id": "ex_4f9a02",
  "user_id": "rt_usr_8a2f1c",
  "duration": "duration_6m",
  "effective_from": "2026-05-24T14:32:00Z",
  "expires_at": "2026-11-24T14:32:00Z",
  "is_permanent": false,
  "kgc_propagated": true
}

Permanent exclusions cannot be undone via API. Block all gameplay immediately on 201.

GET /v1/exclusions/check

Lookup by email or phone. Returns the most-restrictive active exclusion if any (permanent > latest expiry); is_excluded:false otherwise.

curl "https://sandbox.api.anunnakielite.com/v1/exclusions/check?email=[e-mail]" \
  -H "Authorization: Bearer cur_sk_test_EXAMPLEKEY123456789012345678901234"

{
  "is_excluded": true,
  "exclusion_id": "ex_4f9a02",
  "duration": "duration_permanent",
  "expires_at": null,
  "is_permanent": true,
  "source": "kgc_comprehensive"
}

GET /v1/exclusions/snapshot

Paginated tenant-scoped active rows. ?cursor=<base64url>&limit=<1..1000>. Use for nightly reconciliation against missed webhooks.

Webhooks

Event	Fires when
exclusion.created	A user is excluded — locally or via another KGC-licensed operator.
exclusion.expired	A timed exclusion auto-expires.
exclusion.permanent	A permanent (irrevocable) exclusion is registered.
exclusion.kgc_synced	A user is excluded via the KGC Comprehensive Form.

{
  "event": "exclusion.created",
  "event_id": "evt_8f9a02",
  "timestamp": "2026-05-24T14:32:01Z",
  "data": {
    "exclusion_id": "ex_4f9a02",
    "user_email": "[e-mail]",
    "user_phone": "[phone]",
    "duration": "duration_6m",
    "is_permanent": false,
    "expires_at": "2026-11-24T14:32:00Z",
    "source": "rain_trade"
  }
}

Error codes

Status	Code
400	Invalid payload
401	Missing / invalid bearer
404	User not found
409	Already excluded
429	Rate limit (100/min)