Skip to main content
GET
List usage events

Authorizations

x-api-key
string
header
required

API key for authentication. You can find your API key in the Creem dashboard under Settings > API Keys.

Query Parameters

meter_id
string

Only return events consumed by this meter (resolved to the meter’s event name)

Example:

"mtr_abc123"

customer_id
string

Only return events for this customer

Example:

"cust_abc123"

reference
string

Only return the event carrying this event_id

Example:

"order-1234"

limit
number
default:10

Maximum number of events to return

Required range: 1 <= x <= 100
starting_after
string

Cursor for forward pagination — event ID to start after. Usage events are append-only and paginate forward only, so there is deliberately no ending_before.

Example:

"uev_abc123"

Response

Paginated list of usage events

object
string
required

Object type

Example:

"list"

data
object[]
required

Array of usage events

has_more
boolean
required

Whether more items exist beyond this page