API Reference · Checkout Sessions

List checkout sessions

Returns a cursor-paginated list of checkout sessions, newest first.

GET/v1/checkout/sessions

Use `starting_after` and `ending_before` for cursor pagination — do not rely on page numbers. The response is an envelope `{ data, has_more, object: "list" }`.

Returnslist of checkout_session objects

Query parameters

limitintegerdefault: 10

Maximum number of sessions to return. Min 1, max 100.

Constraints: 1 <= limit <= 100

starting_afterstring

Return sessions after this id. Use the id of the last element of the previous page.

ending_beforestring

Return sessions before this id. Use the id of the first element of the previous page.

statusstring

Only return sessions in this status.

Allowed values: OPEN COMPLETE EXPIRED

Errors

422

invalid_request_error

Invalid query parameter (e.g., `limit` out of range).

Request

curl https://lunipay.io/api/v1/checkout/sessions?limit=10 \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "cs_01JRZK8WV3FYMPEQRXJ9HA5NTB",
      "object": "checkout_session",
      "livemode": false,
      "status": "OPEN",
      "payment_status": "unpaid",
      "amount_cents": 5000,
      "currency": "usd",
      "success_url": "https://example.com/thanks?session_id={CHECKOUT_SESSION_ID}",
      "cancel_url": "https://example.com/cart",
      "customer_id": null,
      "customer_email": null,
      "line_items": null,
      "payment_intent_id": null,
      "payment_id": null,
      "metadata": {
        "order_id": "ORD-9821"
      },
      "expires_at": 1713187200,
      "completed_at": null,
      "url": "https://lunipay.io/checkout/cs_01JRZK8WV3FYMPEQRXJ9HA5NTB",
      "created": 1713100800,
      "updated": 1713100800
    }
  ],
  "has_more": false
}