deals_list
Retrieve paginated lists of deals with filters for status, stage, owner, person, or organization.
Instructions
List deals with pagination and filtering options.
Returns a paginated list of deals. Use filters to narrow results by status, stage, owner, person, organization, or pipeline.
Workflow tips:
Use status filter to get only 'open', 'won', 'lost', or 'all_not_deleted' deals
Set owned_by_you=1 to see only your deals
Combine with filter_id to use pre-configured Pipedrive filters
Use start/limit for pagination (default limit: 100, max: 500)
For all deals without pagination, use deals/list_all_auto instead
Common use cases:
List all open deals: { "status": "open" }
List my won deals: { "status": "won", "owned_by_you": 1 }
List deals in a specific stage: { "stage_id": 123 }
List deals for a person: { "person_id": 456 }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | Filter by deal status | |
| stage_id | No | Filter by stage ID | |
| user_id | No | Filter by user (owner) ID | |
| person_id | No | Filter by person ID | |
| org_id | No | Filter by organization ID | |
| pipeline_id | No | Filter by pipeline ID | |
| filter_id | No | ID of the filter to use | |
| sort | No | Field to sort by (e.g., title, value, stage_id) | |
| sort_by | No | Sort direction | |
| owned_by_you | No | Filter deals owned by the authorized user (1 = yes, 0 = no) | |
| start | No | Pagination start | |
| limit | No | Number of items to return |