v1
latestOpenAPI 3.1.02026-07-2684271522.2 KBFiles
Retrieve File
Retrieves the details of an existing file. Supply the unique file ID that was returned when the file was uploaded. Requires the files_read scope.
get/v1/files/{id}
Path parameters
idstring required
Example:ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA
Response
An envelope wrapping a single file object.
Example response
{
"file": {
"file_id": "ffile_01J9XR8M3K7VZ8N2YB4WJ6T0RA",
"purpose": "account_requirement",
"size": 0,
"created_at": "2026-06-15T14:30:00Z",
"expires_at": "2026-06-15T14:30:00Z"
}
}