---
title: "Lists documents attached to a draft contract"
method: GET
path: "/draft-contracts/{draft_contract_id}/documents"
tags: ["Draft Contract Documents"]
---

# Lists documents attached to a draft contract

`GET /draft-contracts/{draft_contract_id}/documents`

## Request

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

Returns all attached documents, including those uploaded through the Rillet application or imported from Salesforce.
Each download URL is valid for up to 1 hour; call this endpoint again to obtain fresh URLs.
Documents are listed oldest first.
Returns an empty `documents` array when the draft contract has no attachments.
Once the draft contract is confirmed, its documents are listed on the contract instead.

## Response `200`

Attached documents

- object
  - `documents` ContractDocument[], required
    - `id` string, uuid, required: Identifier of the attachment.
    - `file_name` string, required
    - `size` integer, required: Size in bytes.
    - `url` string, uri, required: Temporary download URL valid for up to 1 hour.

## Other responses

- `400`: Malformed draft contract id
- `404`: Draft contract not found or not accessible
- `default`: Error

## Changes

- **2026-11-03** `c393d0102005`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/draft-contracts/:draft_contract_id/documents/get.md)

---

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