---
title: "Get document details"
method: GET
path: "/v3/documents/{documentId}"
tags: ["documents"]
---

# Get document details

`GET /v3/documents/{documentId}`

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/documents/{documentId}`
- Auth: none declared

Get details about a document associated with a bill.

From the response, use `downloadLink` in a GET request to download the document.

```
curl '{downloadLink}' --header 'sessionId: {session_id}' --output {document_name}
```

## Path parameters

- `documentId` string, required: BILL-generated ID of the document. The value begins with `0du` or `00h`.

## 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 details response

- DocumentResponseDto: Documents response.
  - `id` string: BILL-generated ID of the document. * A temporary BILL-generated ID is available for the document when the upload is in progress. The value begins with `0du`. * A BILL-generated ID is available for the document when the upload is complete. The value begins with `00h`.
  - `name` string: Document name
  - `createdTime` string, date-time: Created date and time
  - `downloadLink` string: URL for downloading the document. Use the URL in a GET request to download the document.
  - `numOfPages` integer: Number of pages in the document
  - `scanStatus` 'NOT_SCANNED' | 'CLEAN' | 'INFECTED' | 'IN_QUEUE' | 'REJECTED' | 'UNDEFINED': Document scan status

## Other responses

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

## Changes

- **2026-11-03** `54edddceb0a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bill/apis/bill-v3-api/changes/v3/documents/:documentId/get.md)

---

[API](https://skmtc.dev/bill/apis/bill-v3-api.md) - [All operations](https://skmtc.dev/bill/apis/bill-v3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bill/apis/bill-v3-api/revisions/54edddceb0a5?raw)