Retrieve a file

GET / v1 / files /:id

Retrieves the details of an existing file object. After you supply a unique file ID, Stripe returns the corresponding file object. Learn how to access file contents.

Parameters

No parameters.

Returns

If the identifier you provide is valid, a file object returns. If not, Stripe raises an error.

Response

List all files

GET / v1 / files

Returns a list of the files that your account has access to. Stripe sorts and returns the files by their creation dates, placing the most recently created files at the top.

Parameters

purpose string Filter queries by the file purpose. If you don’t provide a purpose, the queries return unfiltered files.

More parameters

created object
ending _ before string
limit integer
starting _ after string

Returns

A dictionary with a data property that contains an array of up to limit files, starting after the starting_after file. Each entry in the array is a separate file object. If there aren’t additional available files, the resulting array is empty.

Response