Retrieve the current processing status of one or more previously uploaded files 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.
Request URL https://{server-hostname}:8383/emsapi/fileupload/status
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers Content-Type string Mandatory
- Request Body application/json Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
--url https://appdomain/emsapi/fileupload/status \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/json' \
--data '{"fileIDs":["9507000000018007"]}'import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;
public class Main {
public static void main(String[] args) {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://appdomain/emsapi/fileupload/status"))
.header("Content-Type", "application/json")
.header("Accept", "application/json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"fileIDs\":[\"9507000000018007\"]}"))
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
payload = "{\"fileIDs\":[\"9507000000018007\"]}"
headers = {
'Content-Type': "application/json",
'Accept': "application/json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("POST", "/emsapi/fileupload/status", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Content-Type", "application/json");
headersMap.put("Accept", "application/json");
data=Map();
data_fileIDs=List();
data_fileIDs.add("value");
data.put("fileIDs",data_fileIDs);
response = invokeUrl
[
url: "https://appDomain/emsapi/fileupload/status"
type: POST
headers: headersMap
body: data
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Content-Type", "application/json")
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/emsapi/fileupload/status' -Method POST -Headers $headers -ContentType 'application/json' -Body '{"fileIDs":["9507000000018007"]}'Sample Request Body Check the upload status of a single file
Copied!
{
"fileIDs": [
"9507000000018007"
]
}
▼ Show full
Response Parameters - HTTP code 200 Response Body - application/json JSON Object
Hide Sub-Attributes response JSON Array
Array of file status objects, one per requested file_id
Show Sub-Attributes JSON Object
Show Sub-Attributes file_id string
Unique identifier of the uploaded file
file_availability_status integer
Numeric status code of the file. For example, 2 indicates the file has been uploaded and is ready for use
remarks string
Additional human-readable remarks about the file status. May be empty
Possible Response Codes Sample Response: HTTP 200 File has been uploaded and is ready for use
Copied!
{
"response": [
{
"file_id": "9507000000018007",
"file_availability_status": 2,
"remarks": ""
}
]
}
▼ Show full
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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.