Report usage events
Reports usage events against a subscription’s meters. Up to 100 events may be reported per call. Duplicate events keyed by meter_id and external_id are silently skipped. Requires the USAGE_WRITE scope.
POST
https://api.pandabase.io/v2/core/stores/{storeId}/usage/ Authentication
Requires a bearer token (sk_…) or an API key in the header Authorization.
Path parameters
storeId string required (length 12–48)
Header parameters
idempotency-key string (length 8–32)
Body parameters
subscription_id string required (length 12–48)
events array of object required No description.
Response 201
Default Response
ok enum required (one of true)
data object required No description.
Response 400
Default Response
ok enum required (one of false)
error string required No description.
Response 404
Default Response
ok enum required (one of false)
error string required No description.
Response 422
Default Response
ok enum required (one of false)
error string required No description.
Request
curl -X POST https://api.pandabase.io/v2/core/stores/:storeId/usage/ \ -H "Content-Type: application/json" \ -d '{"subscription_id":"string","events":[{"event_name":"string","quantity":0,"event_at":"2024-01-01T00:00:00Z","external_id":"string","metadata":{}}]}'Response
{ "ok": true, "data": { "subscriptionId": "sub_8h4t6sqzy3x9w5n2k1m0vqbf", "accepted": 98, "duplicates": 2, "rejected": [] }}