API Reference · Payments

List payments

Returns a cursor-paginated list of payments.

GET/v1/payments

Sorted by `created` descending. Supports filtering by customer, status, and date range.

Returnslist of payment 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.

customerstring

Filter to a single customer id.

statusstring

Filter by status.

Allowed values: PENDING SUCCEEDED FAILED REFUNDED PARTIALLY_REFUNDED

created[gte]integer

Lower bound for the `created` field (unix timestamp, inclusive).

created[lte]integer

Upper bound for the `created` field (unix timestamp, inclusive).

Request

curl "https://lunipay.io/api/v1/payments?status=SUCCEEDED&limit=10" \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "pay_01JRZK9XA0PMK4JHGF7Z3V8TRC",
      "object": "payment",
      "livemode": false,
      "status": "SUCCEEDED",
      "amount_cents": 5000,
      "currency": "usd",
      "customer_id": "cus_01JRZK2Q4T9ZS0VCNA3HX7W9EY",
      "invoice_id": null,
      "checkout_session_id": "cs_01JRZK8WV3FYMPEQRXJ9HA5NTB",
      "payment_link_id": null,
      "payment_method_brand": "visa",
      "payment_method_last4": "4242",
      "billing_email": "ada@example.com",
      "billing_name": "Ada Lovelace",
      "platform_fee_cents": 560,
      "settlement_amount_cents": 4440,
      "settlement_currency": "usd",
      "exchange_rate": null,
      "funds_available_on": "2026-04-21",
      "refunded_amount_cents": 0,
      "metadata": null,
      "created": 1713100800
    }
  ],
  "has_more": false
}