# 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.

## Endpoint

**POST** `/emsapi/fileupload/status`

## Request

### Request URL

`https://[{serverurl}](https://www.manageengine.com/mobile-device-management/help/api/cloud/oauth-authentication-endpoint-domain.html)/emsapi/fileupload/status`

### Scope

`MDMOnDemand.MDMDeviceMgmt.CREATE`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Content-Type** `string` — **Mandatory** — `application/json`
- **Accept** `string` — **Mandatory** — `application/json`

#### Request Body

`application/json`

- `fileIDs` `array` — **Mandatory**
  - 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](https://www.manageengine.com/mobile-device-management/help/api/cloud/files-upload-file-ems.html)

### Sample Request

```curl
curl --request POST \
  --url https://appdomain/emsapi/fileupload/status \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"fileIDs":["9507000000018007"]}'
```

### Sample Request Body

Check the upload status of a single file

```json
{
  "fileIDs": [
    "9507000000018007"
  ]
}
```

## Response

### Response Parameters

#### HTTP Code 200

Response Body — `application/json`

- `response` `JSON array`
  - Array of file status objects, one per requested file_id

### Possible Response Codes

- **200** — HTTP code

### Sample Response: HTTP 200

File has been uploaded and is ready for use

```json
{
  "response": [
    {
      "file_id": "9507000000018007",
      "file_availability_status": 2,
      "remarks": ""
    }
  ]
}
```

## Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**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.