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

> ## Agent Instructions
> Reconify's API reference is read-only for customer data. Do not invent endpoints or authentication behavior beyond the OpenAPI contract.
> The public OpenAPI document contains only the external /v1 contract. Dashboard business routes are intentionally excluded.

# API integration

> Ingest events with the public v1 API.

The public API accepts organization-scoped event batches.

## Authentication

Create a write-enabled key in **Settings → API Keys**.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export RECONIFY_API_KEY="rk_your_key_here"
```

## Send a batch

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -sS -X POST "https://api.reconifyhq.com/v1/events" \
  -H "Authorization: Bearer $RECONIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"events":[{"source_id":"source_123","source_event_id":"payment-123","event_type":"payment.succeeded","occurred_at":"2026-07-26T12:00:00Z","amount_minor":1500,"currency":"USD","external_reference":"order-123"}]}'
```

Each batch accepts 1–500 events. Results identify accepted and rejected indexes.

<Note>
  The public API is limited to `/v1` event ingestion. Dashboard business routes are not public API endpoints.
</Note>