---
title: "List documents for a business"
method: GET
path: "/v1/businesses/{business_id}/documents"
tags: ["documents"]
---

# List documents for a business

`GET /v1/businesses/{business_id}/documents`

## Request

- Base URL: `https://api.middesk.com`
- URL: `https://api.middesk.com/v1/businesses/{business_id}/documents`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/middesk/apis/middesk-api/docs/v1/businesses/:business_id/documents/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `business_id` string, required

## Response `200`

documents found

- DocumentsListDocumentsResponse
  - `object` string
  - `data` Document[]
    - `object` 'document', required
    - `id` string, uuid, required
    - `document_type` string, required: Type of document. Common values include: Initial_Filing, Certificate of Good Standing, Articles of Incorporation, Initial Filing (UCC1), Amendment (UCC3)
    - `filename` string, required: Name of the document file
    - `content_type` string, required: MIME type of the document
    - `size` integer, required: File size in bytes
    - `download_url` string, uri, required: URL to download the document
    - `created_at` string, date-time, required
    - `source` DocumentSource
      - `type` string: Source type (e.g., registration)
      - `id` string, uuid: Source record ID
      - `metadata` object: Additional source metadata
    - `filing_date` string, date-time, nullable
    - `metadata` object: Additional document metadata

## Other responses

- `404`: business not found

## Changes

- **2026-09-17** `4c9cd4e834ba`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `bearer_auth` was added to the API
- **2026-09-12** `668373c892ce`: 1 info
  - api operation id `listDocuments` removed and replaced with `documents_listDocuments`
- **2026-09-03** `ac0d9be94846`: 1 info
  - added the optional property `errors/items/parameter` to the response with the `404` status

[Operation history](https://skmtc.dev/middesk/apis/middesk-api/changes/v1/businesses/:business_id/documents/get.md)

---

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