List a customer's events
A customer's events for one UTC day, newest hour first. Kept for 24 months. Events show here up to about 5 minutes after they are counted. date is today or earlier, at most 24 months ago. Secret and trusted tokens may call it; a limited token may not (403).
AuthorizationBearer <token>A secret, trusted or limited token. See Authentication.
customer_id*stringYour id for the customer.
date*stringOne UTC day, YYYY-MM-DD.
metric_key?stringOnly this metric's events.
limit?integer1 to 100, default 100.
cursor?stringnext_cursor from the page before.
Success.
application/json- response
object?stringAlways usage_event_list.
customer_id?stringYour id for the customer.
date?stringThe UTC day.
metric_key?|The metric asked for, or empty.
data?array<>Events: event_id, metric_key, quantity, operation_id, occurred_at, received_at, properties.
next_cursor?|Pass as cursor for the next page. Empty at the end of the day.
curl -X GET 'https://api.comecero.com/api/v1/usage/events?customer_id=string&date=string'{ "object": "usage_event_list", "customer_id": "cust_8412", "date": "2026-11-12", "metric_key": null, "data": [ { "event_id": "9f1c0a", "metric_key": "ai_tokens", "quantity": "1200", "operation_id": "chat-1001", "occurred_at": "2026-11-12T09:11:11.000Z", "received_at": "2026-11-12T09:11:11.441Z", "properties": { "model": "large" } } ], "next_cursor": null}Read counted usage GET
What the usage meter has counted for one customer and metric, by hour, before it is billed. `from` and `to` are moved to the start of their hour. Kept for 5 minutes. Secret and trusted tokens may call it; a limited token may not (`403`).
Get a customer's usage this period GET
Used, included and percent on each of the customer's plans billed by use. No prices. A shopper's token reads only its own customer (`me` works). With usage billing turned off, `data` is empty. Here `customer_id` is the Comecero customer id, not your own id. Kept for 5 minutes.