Sample - Stripe API
GET/v1/reporting/report_runs

List Report Runs

Lists Report Runs in reverse chronological order, with the most recently created runs first. Use creation-time filters and cursor parameters to narrow the results or navigate through multiple pages.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

5 parameters
createdobjectoptional
Only return Report Runs created at the specified Unix timestamp or within the specified date interval.
ending_beforestringoptional
Cursor based on a Report Run ID; returns the previous page before that run.
expandarray<string>optional
Fields to expand in the response.
limitintegeroptional
Maximum number of Report Runs to return, from 1 to 100. Defaults to 10 when omitted.
starting_afterstringoptional
Cursor based on a Report Run ID; returns the next page after that run.

2 status codes
200Returns a list of Report Run objects with their report types, parameters, statuses, creation times, and result information, plus pagination metadata.
dataarray<ReportRun>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`.
Allowed:list
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired

Error handling

limit must be between 1 and 100 and defaults to 10 when omitted. Use starting_after or ending_before with a Report Run ID for cursor navigation, and provide created as a timestamp or date-range query when filtering by creation time.