---
title: "List Signature Request's Documents"
method: GET
path: "/signature_requests/{signatureRequestId}/documents"
tags: ["Document"]
---

# List Signature Request's Documents

`GET /signature_requests/{signatureRequestId}/documents`

Returns a list of Documents for a given Signature Request.

## Path parameters

- `signatureRequestId` string, uuid, required — The unique identifier for a resource.

## Query parameters

- `nature` object — Filter by nature.

## Response `200`

OK

- Document[]
  - `id` string, uuid, required
  - `filename` string, required
  - `nature` 'attachment' | 'signable_document', required
  - `content_type` string, required
  - `sha256` string, required — Sha256 checksum
  - `is_protected` boolean, required
  - `is_signed` boolean, required
  - `created_at` string, date-time, required
  - `total_pages` integer, nullable, required — Number of pages for signable document
  - `is_locked` boolean, required — If protected by password and not yet unlocked
  - `initials` DocumentInitials, nullable, required
    - `alignment` 'left' | 'center' | 'right', required — Alignment of the initials on the document’s pages.
    - `y` integer, required — Y-axis position of the initials on the first page of the document.
    - `per_page` DocumentInitialsPerPageInner[], required
      - `page` integer, required — Page number.
      - `y` integer, required — Y-axis position of the initials on the page.
  - `total_anchors` integer, required — Number of parsed anchors from the document.
  - `excluded_approvers` string[], required — List of Approver IDs who cannot see this Document.
  - `excluded_signers` string[], required — List of Signer IDs who cannot see this Document.

## Other responses

- `400` — Bad request
- `401` — Access unauthorized
- `403` — Access forbidden
- `404` — Resource not found
- `405` — This method is not allowed
- `429` — Too Many Requests, please try again later.
- `500` — Internal Server Error

---

[API](https://skmtc.net/yousign/apis/public-api-v3.md) · [All operations](https://skmtc.net/yousign/apis/public-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yousign/public-api-v3/revisions/8d258c0b45d6/schema)