Skip to main content
GET
/
v1
/
files
/
{fileId}
Get a file
curl --request GET \
  --url https://api.sandbox.trycollate.ai/v1/files/{fileId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "file_123",
  "status": "pending_upload",
  "fileName": "clinical-note.pdf",
  "contentType": "application/pdf",
  "sizeBytes": null,
  "purpose": "authorization_attachment",
  "downloadUrl": null,
  "createdAt": "2026-03-13T17:00:00.000Z",
  "completedAt": null
}

Authorizations

​
Authorization
string
header
required

Bearer token for WorkOS session JWTs and organization API keys.

Path Parameters

​
fileId
string
required
Example:

"file_123"

Response

File metadata.

​
id
string
required
​
status
enum<string>
required
Available options:
pending_upload,
uploaded,
ready,
failed
​
fileName
string
required
​
contentType
string
required
​
sizeBytes
integer | null
required
​
purpose
enum<string>
required
Available options:
authorization_attachment,
sandbox_payer_document,
generated_artifact,
preview_document
​
downloadUrl
string<uri> | null
required
​
createdAt
string<date-time>
required
​
completedAt
string<date-time> | null
required