v2

latestOpenAPI 3.0.0raw.githubusercontent.com2026-02-16143114179.4 KB
Events

Ingest a batch of usage events

Send up to 100 usage events in a single request. Each event is processed independently - failures do not affect other events.

post/api/events/batch

Request body

Example request

{
  "events": [
    {
      "transactionId": "evt_12345",
      "subscriptionId": "sub_abc123",
      "code": "api_calls",
      "timestamp": "2026-02-10T12:00:00Z",
      "properties": {
        "tokens": 1500,
        "region": "us-east"
      }
    }
  ]
}

Response

Batch processing results

receivednumber required
processednumber required
duplicatesnumber required

Example response

{
  "received": 5,
  "processed": 5
}