List usage events
Returns a list of usage events for a subscription, most recent first. Can be filtered by meter_id and by an event_at range. Requires the USAGE_READ scope.
GET
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)
Query parameters
subscription_id string required (length 12–48)
meter_id string (length 12–48)
from date-time (format date-time)
to date-time (format date-time)
page integer default: 1(range 1–∞, defaults to 1)
limit integer default: 25(range 1–100, defaults to 25)
Header parameters
idempotency-key string (length 8–32)
Response 200
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.
Request
curl -X GET https://api.pandabase.io/v2/core/stores/:storeId/usage/Response
{ "ok": true, "data": { "items": [ { "id": "uev_7g3s5rpyx2w8v4m1j0l9ubae", "externalId": "req-abc-123", "subscriptionId": "sub_8h4t6sqzy3x9w5n2k1m0vqbf", "meterId": "umt_5e1q3npwt0u6s2k8h9j7rzbc", "customerId": "cus_3c0p1lmuq9t4r5j6g8h2vyab", "quantity": 1500, "eventAt": "2026-05-20T14:23:00.000Z", "receivedAt": "2026-05-20T14:23:01.123Z", "metadata": { "endpoint": "/v1/chat", "model": "claude-opus-4-7" } } ], "pagination": { "page": 1, "limit": 25, "total": 1, "totalPages": 1 } }}