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

# Event fields

> Every field of an event, and what the door answers.

Send your systems' events to Casefile, one per request, with a door key made in the app.

## Sending

Send each event as JSON in a `POST` to `https://ingest.casefile.win/events`, with your door key in the header `authorization: Bearer <door key>`.

Send an event again with the same ID after a 429 or 503.
Casefile counts each ID once.

## Fields

| Field | Type | Required | What it is |
| - | - | - | - |
| `id` | string, 1 to 256 characters | Yes | Your ID for the event. Send it again with the same ID and it is counted once. |
| `source` | string, matching `^[a-z][a-z0-9_.-]{0,63}$` | Yes | The system that sent it, such as checkout. |
| `name` | string, matching `^[a-z][a-z0-9_.-]{0,63}$` | Yes | What it measures, such as payment. |
| `occurredAt` | string | Yes | When it happened, as an ISO 8601 time. A time more than 5 minutes ahead of the door is taken as when the door received it. |
| `value` | number, `1` when left out | No | Its value, such as cents for a payment. |
| `tags` | object, up to 4 entries, each value string, up to 64 characters, `{}` when left out | No | Up to 4 names, each with a short value. |

## Answer

Accepted and stored, and on its way to be read.
While Casefile staff have paused the organization, its events are accepted and stored, and read once it is resumed.

| Field | Type | Required | What it is |
| - | - | - | - |
| `accepted` | string | Yes | The event's ID. |
| `traceId` | string | Yes | Quote this when asking what happened to the event. |
| `limitPerSecond` | number | Yes | Events a second your organization may send now. |

Any other answer is a refusal. [Limits and refusals](https://docs.casefile.win/reference/limits.md#refusals) lists each one.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.