v1
latestOpenAPI 3.1.02026-07-2684271522.2 KBFiles
List Files
Returns a list of your files, sorted by creation date with the most recently created files first. Pass purpose to filter to a single file purpose. Requires the files_read scope.
get/v1/files
Query parameters
purpose'account_requirement' | 'additional_verification' | 'business_icon' | 'business_logo' | 'customer_signature' | 'dispute_evidence' | 'document_provider_identity_document' | 'finance_report_run' | 'financial_account_statement' | 'identity_document' | 'identity_document_downloadable' | 'issuing_regulatory_reporting' | 'pci_document' | 'platform_terms_of_service' | 'selfie' | 'sigma_scheduled_query' | 'tax_document_user_upload' | 'terminal_android_apk' | 'terminal_reader_splashscreen'
What the uploaded file will be used for.
Example:account_requirement
limitinteger nullable
Example:10
starting_afterstring nullable
Example:ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA
ending_beforestring nullable
Example:ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA
Response
An envelope wrapping a list of file objects.
Example response
{
"files": [
{
"file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"purpose": "account_requirement",
"size": 0,
"created_at": "2026-06-15T14:30:00Z",
"expires_at": "2026-06-15T14:30:00Z"
}
]
}