Skip to main content
Retrieves the details of an existing file upload. This is useful for checking the status of an upload or getting the file URL after completion.

Method

Parameters

string
required
The ID of the file upload to retrieve.

Response

Returns a FileUploadObjectResponse with the current state of the file upload.
string
Always "file_upload"
string
Unique identifier for the file upload.
string
Current status of the file upload.Values: "pending" | "processing" | "complete" | "failed"
string
ISO 8601 timestamp when the file upload was created.
string
ISO 8601 timestamp when the file upload was last updated.
object
File information (only present when status is "complete")
string
Name of the uploaded file.
string
MIME type of the file.

Examples

Check upload status

Poll for completion

Get file URL with error handling