GET /v1/payments endpoint returns payment records associated with your merchant account. Results are sorted by date descending and support cursor-based pagination so you can retrieve large datasets incrementally. This endpoint requires the donations:read permission on your API key.
The
/v1/payments endpoint replaces the deprecated /v1/donations endpoint. If you are still using /v1/donations, migrate before the 2026-07-01 sunset date.Request
Maximum number of payment records to return per page. Accepts values between 1 and 100.
Pagination cursor returned by a previous response. Pass this value to retrieve the next page of results. Omit on the first request.
Response
The Payment object never includes the display-currency fields (
displayCurrency, displayAmount, fxRate, fxRateTableId, fxRateAsOf). They are display only (every charge, refund and payout stays in USD) and arrive on the donation.* webhooks and the deprecated /v1/donations endpoints. See Display-currency fields.Pagination cursor for the next page. Pass this as the
lastEvaluatedKey query parameter on your next request. Absent when hasMore is false.Example
Response