# escrows_list

> Search for escrows.

<!-- Source: https://docs.actuallycare.com/tools/escrows/escrows_list -->

Search for escrows. Returns IDs only by default for efficiency.

Response includes relatedIds with BOTH clientIds and contactIds:
- relatedIds.clientIds: CLIENT table IDs → use with [`clients_bulk_update`](/tools/clients/clients_bulk_update)
- relatedIds.contactIds: CONTACT table IDs → use with [`contacts_get`](/tools/contacts/contacts_get) (contact_ids)

```text
WORKFLOW: To mark clients as closed when escrow closes:
1. escrows_list({ status: 'closed' }) → get relatedIds.clientIds
2. clients_bulk_update({ client_ids: relatedIds.clientIds, updates: { status: 'closed' } })
```

Direct workflow - no intermediate [`clients_list`](/tools/clients/clients_list) step needed!

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search term (searches property address, escrow number) |
| `status` | enum | No | Filter by escrow status (default: all) · One of: `all`, `active`, `pending`, `closed`, `cancelled`, `fell_through` |
| `fields` | array of enum | No | Field groups to include. Empty/omitted = IDs only (most efficient). Options: basic (id, display_id, address, status), dates (closing_date, etc), financial (price, commission), clients (buyers/sellers), location (city, state), property (beds, baths), full (all fields). · Values: `basic`, `dates`, `financial`, `clients`, `location`, `property`, `full` |
| `limit` | string or number | No | Max results. Use a number (e.g. "25") or "all". "all" and any value above 200 are capped at 200 server-side. · Max: 200 |
| `offset` | number | No | Skip N records for pagination. Use pagination.nextOffset from previous response. |
| `slim` | boolean | No | DEPRECATED: Use fields parameter instead. slim=true maps to fields=[] (IDs only). |

## Example prompts

- "Which of my escrows are still active right now?"
- "Find the escrow for 412 Birchwood Ln and show its closing date and price."

## Safety

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

## Previous name

This tool was previously published as `search_escrows`. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.