Create a file

POST / v1 / files

To upload a file to Stripe, you need to send a request of type multipart/form-data. Include the file you want to upload in the request, and the parameters for creating a file.

All of Stripe’s officially supported Client libraries support sending multipart/form-data.

Parameters

• file map Required A file to upload. Make sure that the specifications follow RFC 2388, which defines file transfers for the multipart/form-data protocol.
• purpose enum Required The purpose of the uploaded file. Possible enum values account_requirement Additional documentation requirements that can be requested for an account. additional_verification Additional verification for custom accounts. business_icon A business icon. business_logo A business logo. customer_signature Customer signature image. dispute_evidence Evidence to submit with a dispute response. identity_document A document to verify the identity of an account owner during account provisioning. issuing_regulatory_reporting Additional regulatory reporting requirements for Issuing. pci_document A self-assessment PCI questionnaire. platform_terms_of_service A copy of the platform’s Terms of Service. Show 5 more

More parameters

• file _ link _ data object

Returns

Returns the file object.

Response

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