# deals_list

> Search for vendor deals by title, status, vendor type, or deal type.

<!-- Source: https://docs.actuallycare.com/tools/deals/deals_list -->

Search for vendor deals by title, status, vendor type, or deal type. Returns pagination info (total_count, has_more, offset, limit). Results include: id, display_id, title, vendor_type, deal_type, status, payment_status, amount, fee, commission_amount, property_address, contact info, created_at. Filter by status (pending/in_progress/completed/invoiced/paid/cancelled/disputed), payment_status (unpaid/invoiced/paid/refunded), vendor_type, or deal_type. For a specific deal by ID, use [`deals_get`](/tools/deals/deals_get) instead. For aggregate stats, use [`deals_stats`](/tools/deals/deals_stats).

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search term - matches against title, property_address, notes (case-insensitive partial match) |
| `status` | enum | No | Filter by status. pending=awaiting start, in_progress=work underway, completed=work done, invoiced=invoice sent, paid=payment received, cancelled=deal off, disputed=payment issue (default: all) · One of: `all`, `pending`, `in_progress`, `completed`, `invoiced`, `paid`, `cancelled`, `disputed` |
| `payment_status` | enum | No | Filter by payment status (default: all) · One of: `all`, `unpaid`, `invoiced`, `paid`, `refunded` |
| `vendor_type` | string | No | Filter by vendor type (e.g. lender, inspector, escrow_officer, title_rep, appraiser, contractor, photographer) |
| `deal_type` | string | No | Filter by deal type (e.g. inspection, appraisal, escrow_service, title_service, photography, staging, repair) |
| `vertical` | string | No | Filter by industry vertical (e.g., lending, insurance, inspection) |
| `date_from` | string | No | Show deals created on or after this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `date_to` | string | No | Show deals created on or before this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `archived` | boolean | No | Include archived deals (default: false) |
| `limit` | number | No | Maximum results (default: 50, max: 500) · Max: 500 · Min: 1 |
| `offset` | number | No | Skip N results for pagination (default: 0) · Min: 0 |

## Example prompts

- "Show me all my unpaid inspection deals from the last 30 days."
- "Pull up every invoiced deal that has not been paid yet."

## Safety

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