Returns the availability status and remarks for one or more files identified by their file IDs. Use this to verify whether a file upload has completed before referencing it in other API calls.
post /emsapi/fileupload/status
https://{server-hostname}:8383/emsapi/fileupload/status Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Array of file_id values (as strings) to check status for. Each file_id must have been obtained from a prior file upload response, e.g. Upload a File Using Module Configuration
curl --request POST \
--url https://appdomain/emsapi/fileupload/status \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"fileIDs":["9507000000018007"]}'Check the upload status of a single file
{
"fileIDs": [
"9507000000018007"
]
}
Array of file status objects, one per requested file_id
Unique identifier of the uploaded file
Numeric status code of the file. For example, 2 indicates the file has been uploaded and is ready for use
Additional human-readable remarks about the file status. May be empty
Unique identifier of the uploaded file
Numeric status code of the file. For example, 2 indicates the file has been uploaded and is ready for use
Additional human-readable remarks about the file status. May be empty
File has been uploaded and is ready for use
{
"response": [
{
"file_id": "9507000000018007",
"file_availability_status": 2,
"remarks": ""
}
]
}
![]()
Duration: 1 minute | Threshold: 500 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.