deals_list_archived
Retrieve a paginated list of archived deals, with filters by status, user, stage, person, and more.
Instructions
List archived deals with pagination and filtering options.
Returns a paginated list of archived deals. Archived deals are deals that have been removed from active pipelines.
Workflow tips:
Use same filters as deals/list (status, stage_id, user_id, person_id, org_id, etc.)
Filter by user_id to see archived deals by specific user
Combine with filter_id to use pre-configured Pipedrive filters
Use start/limit for pagination (default limit: 100, max: 500)
Useful for historical analysis and cleanup
Common use cases:
List all archived deals: {}
List archived deals by user: { "user_id": 123 }
List archived deals in a specific stage: { "stage_id": 5 }
List archived 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) | |
| 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 |