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

# Events

> Ingest consented activity and read processing status.

`POST /v1/events` is the main write. It is non-blocking: you get `202` after durable accept, FIFO sequence, and enqueue. Profile reads see the event after archive projection (`processed`).

`Idempotency-Key` is required. Replays return the original result. A reused key with a different body returns `409`.

## Endpoints in this group

| Method | Path                                                          | Scope          |
| ------ | ------------------------------------------------------------- | -------------- |
| `POST` | [`/v1/events`](/partners/api-reference/events-ingest)         | `events:write` |
| `POST` | [`/v1/events/batch`](/partners/api-reference/events-batch)    | `events:write` |
| `GET`  | [`/v1/events/{event_id}`](/partners/api-reference/events-get) | `events:read`  |

Batch accepts 1–100 events. Ordering is guaranteed per customer, not across customers.

Statuses: `accepted`, `processing`, `processed`, `failed`, `rejected`.

How to shape `event_type`, `ontology_category`, and `object`: [events and intent ontology](/partners/events-and-intents).