API Reference · Events

List events

Returns a cursor-paginated list of events.

GET/v1/events

Filter by type or type prefix. Sorted by `created` descending. Only events from the current livemode are returned.

Returnslist of event objects

Query parameters

limitintegerdefault: 10

Max results.

Constraints: 1 <= limit <= 100

starting_afterstring

Cursor for the next page.

ending_beforestring

Cursor for the previous page.

typestring

Exact event type, e.g. `payment.succeeded`.

type[]array

Multiple exact type matches.

created[gte]integer

Lower bound on `created` (unix, inclusive).

created[lte]integer

Upper bound on `created` (unix, inclusive).

Request

curl "https://lunipay.io/api/v1/events?type=payment.succeeded&limit=10" \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "evt_01JRZKD1KMN8RZJX4QV5W7YEFH",
      "object": "event",
      "livemode": false,
      "type": "checkout.session.completed",
      "api_version": "2026-04-14",
      "data": {
        "object": {
          "id": "cs_01JRZK8WV3FYMPEQRXJ9HA5NTB",
          "object": "checkout_session",
          "status": "COMPLETE",
          "payment_status": "paid",
          "amount_cents": 5000,
          "currency": "usd"
        }
      },
      "created": 1713100900
    }
  ],
  "has_more": false
}