Sample - Stripe API
GET/v1/files

List all files

Lists files that the authenticated user can access, ordered from most recently created to oldest. Use purpose to filter the results, created to constrain the creation interval, and cursor parameters to navigate between pages. Set limit to control the page size.

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

6 parameters
createdobjectoptional
Filters files by creation time using an integer timestamp or a range with `gt`, `gte`, `lt`, or `lte`.
ending_beforestringoptional
A cursor containing a file object ID; returns the page before that position.
expandarray<string>optional
Specifies which fields in the response to expand; each field name can contain up to 5,000 characters.
limitintegeroptional
The number of files to return. Must be between 1 and 100 and defaults to 10 when omitted.
purposestringoptional
Filters files by purpose, such as `account_requirement`, `additional_verification`, `business_icon`, `business_logo`, or `customer_signature`.
Allowed:account_requirementadditional_verificationbusiness_iconbusiness_logocustomer_signaturedispute_evidencedocument_provider_identity_documentfinance_report_runfinancial_account_statementidentity_documentidentity_document_downloadableissuing_regulatory_reporting
starting_afterstringoptional
A cursor containing a file object ID; returns the page after that position.

2 status codes
200Returns a file list containing file objects, a `has_more` indicator, the list object type, and the list URL.
dataarray<File>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 an integer between 1 and 100 and defaults to 10 when omitted. created must be an integer timestamp or a range using gt, gte, lt, or lte; purpose must use an accepted file purpose, and cursor values must identify list positions.