---
title: "List all documents"
method: GET
path: "/v1/links/{link_id}/documents/"
tags: ["Uploaded Documents"]
---

# List all documents

`GET /v1/links/{link_id}/documents/`

The endpoint returns a list of documents.

**Note:** When the `other` document type is enabled in the document upload settings of your customization template, end users can upload arbitrary documents that don't fit the other categories. Truv does not parse these `OTHER` documents into structured data (they are captured only), but you can collect the uploaded files through this Uploaded Documents API.

## Response `200`

- Document[]
  - `id` string — Document ID
  - `type` 'PAYSTUB' | 'W2' | 'F1099' | 'F1040' | 'VOLUNTEER_LETTER' | 'INSURANCE_HOME_POLICY' | 'INSURANCE_AUTO_POLICY' | 'OTHER' — Document type. `OTHER` documents are captured only: end users can upload arbitrary files that Truv does not parse into structured data. These documents are not parsed, but you can still collect them through the Uploaded Documents API. `OTHER` is only returned when the `other` document type is enabled in the document upload settings of your customization template.
  - `subtype` 'F1099_DIV' | 'F1099_G' | 'F1099_INT' | 'F1099_MISC' | 'F1099_NEC' | 'F1099_R' | 'F_SSA1099' | 'VOL_HOURS_LOG' | 'VOL_TRANSCRIPT' | 'null', nullable — Document subtype
  - `file` string, uri — Document file link. The file could be absent or partially uploaded.
  - `filename` string, required — Document file name
  - `mimetype` string — Document mimetype
  - `created_at` string, date-time — Date when a document was uploaded
  - `updated_at` string, date-time — Date when a document was updated

## Other responses

- `401` — HTTP 401 Unauthorized
- `403` — HTTP 403 Forbidden

---

[API](https://skmtc.net/truv/apis/truv-api.md) · [All operations](https://skmtc.net/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truv/truv-api/revisions/3d9b9702e0e3/schema)
