Batch report usage events

View as Markdown

Reports multiple usage events in a single request. Accepts 1 to 1,000 events per batch.

Each event is processed independently — some may succeed while others fail. The response includes counts of accepted and rejected events, along with error details for any failures.

Authentication

AuthorizationBearer

Use a secret key (sk_test_* or sk_live_*) for full read/write access, or a public key (pk_test_* or pk_live_*) for read-only access.

Request

This endpoint expects an object.
eventslist of objectsRequired

Array of usage events to report (1-1,000 per batch).

Response

Batch processed
dataobject

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error