# pipeline_records_list

> List pipeline records with filtering.

<!-- Source: https://docs.actuallycare.com/tools/pipelines/pipeline_records_list -->

List pipeline records with filtering. Use to browse a pipeline or find record IDs before get/update/move operations. Filter by stage, care status, priority, source, or search by name/email/title. Returns records with contact info and stage details.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `pipeline_type_id` | string | No | Filter by pipeline type · Format: UUID |
| `stage_key` | string | No | Filter by stage key (e.g., "lead", "demo", "trial") |
| `care_status` | enum | No | Filter by care status · One of: `no_status`, `cared`, `needs_care`, `didnt_care` |
| `priority` | enum | No | Filter by priority level · One of: `low`, `medium`, `high`, `urgent` |
| `source` | string | No | Filter by source |
| `search` | string | No | Search by contact name, email, or record title |
| `is_archived` | boolean | No | Include archived records (default: false) |
| `page` | integer | No | Page number (default: 1) · Min: 1 |
| `limit` | integer | No | Results per page (default: 25) · Max: 100 · Min: 1 |
| `sort_by` | enum | No | Sort field · One of: `created_at`, `updated_at`, `estimated_ltv`, `expected_close_date`, `priority` |
| `sort_order` | enum | No | Sort direction · One of: `asc`, `desc` |

## Example prompts

- "List everyone sitting in the demo stage of my pipeline right now."
- "Show urgent pipeline records that still need care, sorted by expected close date."

## Safety

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