List Meter Events

List recent usage events recorded for a specific meter. Useful for debugging and auditing event ingestion.

GET /v1/meters/{id}/events

TypeScript SDK

TypeScript

import { Solifyn } from 'solifyn';

const solifyn = new Solifyn({ apiKey: 'your_private_api_key_here' });

// List recent billing events recorded for a meter
const events = await solifyn.meters.listEvents('mtr_019e56a1...', {
  limit: 50
});
console.log('Recorded Events:', events);

200

{
  "meterId": "mtr_8Z1aB2cD3eF4gH5iJ6kL7m",
  "items": [
    {
      "id": "evt_9Y3kP4qR7tU1vW2xZ5aB6c",
      "meterId": "mtr_8Z1aB2cD3eF4gH5iJ6kL7m",
      "customerId": "cus_8n7m6l5k4j3h2g1f0e9d8c",
      "value": 1,
      "timestamp": "2026-05-23T10:00:00.000Z",
      "processedAt": "2026-05-23T10:00:01.000Z",
      "metadata": {
        "plan": "enterprise",
        "region": "asia-southeast-1"
      }
    }
  ],
  "count": 100
}

Authorizations

Authorization · string · header · required

Authenticate requests using your standard bearer API key (e.g. YOUR_API_KEY).

Path Parameters

id · string · required

The unique meter ID.

Example:

"mtr_8Z1aB2cD3eF4gH5iJ6kL7m"

Query Parameters

limit · number · default: 100

Maximum number of usage events to return.

Response

200 - application/json

Meter events retrieved successfully.

Represents a paginated-like response containing recent usage events recorded for a meter.

meterId · string · required

The unique meter ID.

Example:

"mtr_8Z1aB2cD3eF4gH5iJ6kL7m"

items · object[] · required

List of recent usage events.

Show child attributes

count · number · required

Number of returned usage events.

Example:

100