Files
Get file processing status
Returns the current processing status, pipeline steps, and warnings. Poll until `processingStatus` is `PROCESSED` before attaching the file to a message.
GET
/v1/files/{file_id}/statusAuthorization
APIKeyHeader api-key<token>
In: header
Path Parameters
file_id*File Id
Format
uuidHeader Parameters
user-id*User-Id
ID of the end user the file belongs to.
Match
^[A-Za-z0-9._\-@:]+$Length
length <= 255Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/files/497f6eca-6276-4993-bfeb-53cbbbba6f08/status" \ -H "user-id: string"{ "processing_status": "PROCESSING", "processing_steps": [ { "createdAt": "2026-04-15T09:43:13.247Z", "endedAt": "2026-04-15T09:43:14.204Z", "status": "ANTIVIRUS_SCANNING" } ], "warnings": { "empty": false, "infected": false, "length": false }}