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

## Endpoints

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

## Request URL

```text
https://{server-hostname}:8383/emsapi/fileupload/status
```

## Scope

```text
Common.READ
```

## Header

```text
Authorization: d92d4xxxxxxxxxxxxx15f52
```

## Request Parameters

### Request Headers

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

### Request Body

`application/json`

- `JSON Object`
  - **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/products/desktop-central/help/api/onpremise/files-upload-file-ems.html)

## Sample Request

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

### Sample Request Body

Check the upload status of a single file

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

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- `JSON Object`
  - **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": ""
    }
  ]
}
```

![](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.