List Payments

GEThttps://api.acme.com/v1/payments

Returns a paginated list of payments for your account.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

status"succeeded" | "pending" | "failed"

Filter by payment status.

Allowed values: "succeeded" | "pending" | "failed"
limitintegerdefault: 20

Number of results per page. Max 100.

Required range: x <= 100
Default: 20
cursorstring

Pagination cursor from a previous response.

Response

200application/json

A paginated list of payments

dataarray<object>
data.idstring

Payment ID. Starts with `pay_`.

data.amountinteger

Amount in cents.

data.currencystring

Three-letter ISO currency code.

data.status"succeeded" | "pending" | "failed"

Current payment status.

Allowed values: "succeeded" | "pending" | "failed"
data.customerobject
data.created_atstring<date-time>
has_moreboolean

Whether more results exist beyond this page.

next_cursorstring

Pass as `cursor` to fetch the next page.