Ingest multiple usage events

Record multiple usage events in a single request for efficient bulk ingestion.

Limits:

  • Maximum 1000 events per batch
  • Events are processed asynchronously
  • All events must be valid or the entire batch will be rejected

Use cases:

  • Bulk import of historical data
  • Batch processing of events
  • High-throughput event ingestion

For quota enforcement and rate limiting, use POST /v1/track instead.

POST
/events/batch
AuthorizationBearer <token>

Project API key

In: header

Request Body

application/json

events*

Array of events to ingest (max 1000)

Itemsitems <= 1000

Response Body

application/json

application/json

application/json

curl -X POST "https://api.limitry.com/v1/events/batch" \  -H "Content-Type: application/json" \  -d '{    "events": [      {        "customerId": "string",        "eventType": "string"      }    ]  }'
{
  "count": 5
}
{
  "error": "Invalid request"
}
{
  "error": "Invalid or missing API key"
}