---
title: "List a client's documents"
method: GET
path: "/v1/clients/{client_id}/documents"
tags: ["Documents"]
---

# List a client's documents

`GET /v1/clients/{client_id}/documents`

## Request

- Base URL: `https://api.magnetictax.com`
- URL: `https://api.magnetictax.com/v1/clients/{client_id}/documents`
- Auth: HTTP bearer

Each document with its `state` (uploading / uploaded / submitted), so you can see what has been uploaded and which documents the next submission will take.

## Response `200`

The client's documents

- object
  - `documents` Document[]
    - `category` 'tax_return' | 'workpapers' | 'review_notes', nullable: For output documents only: 'tax_return' (the tax-software return file, e.g. a Drake .DI5 / UltraTax .csd), 'workpapers' (the workpapers PDF), or 'review_notes' (the reviewer's notes, delivered as a .txt and a rendered PDF). Absent on input documents and internal-only outputs.
    - `download_url` string, nullable
    - `filename` string
    - `id` integer
    - `state` 'uploading' | 'uploaded' | 'submitted': Lifecycle state of the document: 'uploading' (presigned, not yet confirmed), 'uploaded' (available for the next submission), or 'submitted' (attached to a submission).

## Other responses

- `404`: Not found
- `429`: Rate limited — retry after the `Retry-After` delay

---

[API](https://skmtc.dev/magnetictax/apis/magnetic-integrations-api.md) - [All operations](https://skmtc.dev/magnetictax/apis/magnetic-integrations-api/llms.txt) - [OpenAPI document](https://skmtc.dev/magnetictax/apis/magnetic-integrations-api/revisions/11854873aa89?raw)