GET
/v1/chargesList all charges
Lists charges previously created for the account, ordered with the most recent charges first. Filter by customer, payment_intent, transfer_group, or created, and use starting_after or ending_before with limit to paginate the results.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
createdobjectoptional
Filters charges by creation time using a Unix timestamp or a range with `gt`, `gte`, `lt`, or `lte`.
customerstringoptional
Filters charges to those associated with the specified customer identifier.
ending_beforestringoptional
A cursor identifying an object before which to retrieve the previous page of charges.
expandarray<string>optional
Fields to expand in the response.
limitintegeroptional
The number of charges to return. Must be between 1 and 100; defaults to 10 when omitted.
payment_intentstringoptional
Filters charges created by the specified PaymentIntent identifier.
starting_afterstringoptional
A cursor identifying an object after which to retrieve the next page of charges.
transfer_groupstringoptional
Filters charges by transfer group; results are limited to 100 for this filter.
200Returns a list object containing charge objects ordered from newest to oldest, a pagination indicator, the list object type, and the access URL.
dataarray<Charge>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultReturns an error object containing details about the failed request.
errorobjectrequired
Error handling
limit must be between 1 and 100 when supplied. Use created with a Unix timestamp or range filters, and provide starting_after or ending_before as object-ID cursors when paging through charges.