---
title: "List Bill Documents"
method: GET
path: "/api/v1/bills/{bill_id}/documents"
tags: ["bills"]
---

# List Bill Documents

`GET /api/v1/bills/{bill_id}/documents`

## Request

- Base URL: `https://api.billcommons.org`
- URL: `https://api.billcommons.org/api/v1/bills/{bill_id}/documents`
- Auth: none declared

## Path parameters

- `bill_id` string, uuid, required

## Response `200`

Successful Response

- BillDocumentOut[]
  - `id` string, uuid, required
  - `bill_version_id` string, uuid, required
  - `media_type` string, nullable
  - `url` string, nullable
  - `has_extracted_text` boolean
  - `text_is_partial` boolean: True when text was extracted from a malformed PDF with one or more unreadable pages -- the text is real but incomplete, so diffs/quotes against it may be missing sections.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/billcommons/apis/bill-commons-api.md) · [All operations](https://skmtc.dev/billcommons/apis/bill-commons-api/llms.txt) · [OpenAPI document](https://skmtc.dev/billcommons/apis/bill-commons-api/revisions/bfb8cd50a317?raw)