# documents_list

> List the documents attached to a specific entity (escrow, listing, client, lead, or appointment).

<!-- Source: https://docs.actuallycare.com/tools/documents/documents_list -->

List the documents attached to a specific entity (escrow, listing, client, lead, or appointment). Returns each document id (pass it to [`documents_get_risks`](/tools/documents/documents_get_risks)), filename, original_name, document_type, category, mime_type, file_size, requires_signature, signed_at, is_primary_contract, and created_at, newest first. Use this to see what is on file for a transaction (the RPA, TDS, NHD, pre-approval on an escrow). Read-only; returns only documents the agent can access under their tenant scope.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `entity_type` | enum | Yes | The kind of record the documents are attached to. · One of: `escrow`, `listing`, `client`, `lead`, `appointment` |
| `entity_id` | string | Yes | The id of the escrow, listing, client, lead, or appointment. · Max length: 50 · Min length: 1 |
| `limit` | number | No | Max documents to return (default 50). · Max: 200 · Min: 1 |

## Example prompts

- "Show me my documents."

## Safety

**Read-only.** This tool never changes your data — it only looks things up. Safe to run anytime.