Deals API

Manage deals and pipeline stages.

Endpoints

List Deals

GET /api/v1/deals

Query Parameters:

Parameter	Type	Description
stage	string	Pipeline stage
contactId	string	Filter by contact
minValue	number	Minimum deal value
maxValue	number	Maximum deal value
page	number	Page number
limit	number	Per page

Get Deal

GET /api/v1/deals/:id

Create Deal

POST /api/v1/deals

{
  "name": "Enterprise Contract",
  "contactId": "contact-uuid",
  "value": 5000,
  "currency": "USD",
  "stage": "qualified",
  "expectedCloseDate": "2026-03-15",
  "pipelineId": "pipeline-uuid"
}

Update Deal

PATCH /api/v1/deals/:id

Move Deal Stage

PATCH /api/v1/deals/:id/stage

{
  "stage": "proposal"
}

Delete Deal

DELETE /api/v1/deals/:id