---
title: "Get list of documents"
method: GET
path: "/v3/documents/bills/{billId}"
tags: ["documents"]
---

# Get list of documents

`GET /v3/documents/bills/{billId}`

## Request

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

Get a list of documents 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

- `billId` string, required: BILL-generated ID of the bill. The value begins with `00n`.

## Query parameters

- `max` integer, nullable: Maximum number of results
- `page` string, nullable: Next page of results. When a list has multiple pages, the `nextPage` and `prevPage` values in the response enable you to navigate between the pages of results. Set `page` as the `nextPage` or `prevPage` value for navigation.

## 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 list of documents response

- ListDocumentResponseDto: Response from a list API request with paging references.
  - `nextPage` string
  - `prevPage` string
  - `results` DocumentResponseDto[]
    - `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/bills/:billId/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)