# partners_list

> Search for vendor partners by name, status, vendor type, or tier.

<!-- Source: https://docs.actuallycare.com/tools/partners/partners_list -->

Search for vendor partners by name, status, vendor type, or tier. Returns pagination info (total_count, has_more, offset, limit). Results include: id, display_id, title, vendor_type, status, tier, partner_since, care_status, contact info, created_at. Filter by status (onboarding/active/preferred/paused/churned), tier (standard/preferred/vip), vendor_type, or care_status. For a specific partner by ID, use [`partners_get`](/tools/partners/partners_get) instead. For aggregate stats, use [`partners_stats`](/tools/partners/partners_stats).

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search term - matches against title, notes (case-insensitive partial match) |
| `status` | enum | No | Filter by status. onboarding=setting up, active=regular partner, preferred=top partner, paused=temporarily inactive, churned=relationship ended (default: all) · One of: `all`, `onboarding`, `active`, `preferred`, `paused`, `churned` |
| `tier` | enum | No | Filter by partner tier (default: all) · One of: `all`, `standard`, `preferred`, `vip` |
| `vendor_type` | string | No | Filter by vendor type (e.g. lender, inspector, escrow_officer, title_rep, appraiser, contractor, photographer) |
| `care_status` | enum | No | Filter by care status (default: all) · One of: `all`, `no_status`, `cared`, `needs_care`, `didnt_care` |
| `date_from` | string | No | Show partners created on or after this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `date_to` | string | No | Show partners created on or before this date (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `archived` | boolean | No | Include archived partners (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 preferred tier lender partners."
- "List active inspector partners flagged as needing care this month."

## Safety

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