List Deals

Retrieve a list of deals for your organization with optional filtering and pagination.

Endpoint

GET
/deals

Request

Loading editor...

Response

json
Loading editor...

Query Parameters

ParameterTypeDescription
organization_idNumberID of the organization to fetch deals for (required)
statusStringFilter deals by status ('open', 'won', 'lost')
pipeline_idNumberFilter deals by pipeline ID
pipeline_stage_idNumberFilter deals by pipeline stage ID
$limitNumberNumber of deals to return (default: 10)
$skipNumberNumber of deals to skip (for pagination)
$sortObjectSort criteria (e.g., { "created_at": -1 } for newest first)
fastJoinForDealsListBooleanInclude associated data like company, contact, pipeline stage, and owner (recommended)

Report an issue with this documentation

Please log in to report issues with our documentation.