Events API Overview

Complete reference for the Atlas Events API — high-throughput event ingestion for iGaming operations.

Base URL

https://events.atlas.io

Authentication

API Key (Domain Events)

Used for all /api/v1/* endpoints.

X-API-Key: atl_live_xxxxxxxxxxxxxxxx

Get your API key at Dashboard → Settings → API Keys.

JWT Bearer (Generic Events)

Used for /v1/events and /v1/events/batch.

Authorization: Bearer <jwt_token>

Obtain a token via POST /auth/login.

Endpoints

Domain Event Endpoints

Method	Path	Description
POST	/api/v1/user	Single user event
POST	/api/v1/user/batch	Batch user events (up to 500)
POST	/api/v1/transaction	Single transaction event
POST	/api/v1/transaction/batch	Batch transaction events
POST	/api/v1/casino	Single casino bet event
POST	/api/v1/casino/batch	Batch casino events
POST	/api/v1/sport	Single sport bet event
POST	/api/v1/sport/batch	Batch sport events

Generic Event Endpoints

Method	Path	Description	Auth
POST	/v1/events	Single generic event	JWT
POST	/v1/events/batch	Batch generic events (up to 500)	JWT

Health Endpoints

Method	Path	Description
GET	/health/live	Liveness probe (Kubernetes)
GET	/health/ready	Readiness probe (Kubernetes)

Response Codes

Code	Meaning
202	Event(s) accepted and published to Kafka
207	Batch partial success — check failed count
400	Validation error — entire batch rejected
401	Invalid or missing API key / token
422	Business rule violation
429	Rate limit exceeded
502	Kafka publish failure — event routed to DLQ

OpenAPI Specification

The full OpenAPI 3.0 spec is available for download and import:

• Download: openapi/events.v3.json
• Version: OpenAPI 3.0.3
• Source: generated from the Swagger 2.0 spec produced by swaggo

Import into Postman, Insomnia, or any OpenAPI-compatible tool.

SDK Support

For JavaScript/TypeScript integrations, use the Atlas SDK instead of calling the API directly.

→ npm install @atlas-platform/sdk