---
title: "Get document upload status"
method: GET
path: "/v3/documents/upload-status"
tags: ["documents"]
---

# Get document upload status

`GET /v3/documents/upload-status`

Get status of a document upload. Use this endpoint to identify when a document upload is complete.
* BILL generates an `uploadId` for the document when the upload is in progress (`IN_PROGRESS`). The value begins with `0du`.
* BILL generates a `documentId` for the document when the upload is complete (`UPLOADED`). The value begins with `00h`.

## Query parameters

- `ids` string, required — Document upload IDs. You can set the IDs as comma-separated values.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Response `200`

Get document upload status response

- DocumentUploadStatusResponseDto[]
  - `documentId` string — BILL-generated ID of the document. The value begins with `00h`.
  - `uploadId` string — BILL-generated ID of the document upload. The value begins with `0du`.
  - `status` 'UPLOADED' | 'IN_PROGRESS' | 'IVA_PROCESSING' | 'AUTOSAVED' | 'FAILED' — Document upload status.
  - `scanStatus` 'NOT_SCANNED' | 'CLEAN' | 'INFECTED' | 'IN_QUEUE' | 'REJECTED' | 'UNDEFINED' — Document scan status.

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)