ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APICRM Pipelines & DealsList Deals

List Deals

Lists sales deals with contacts, stages, owners, and weighted values.

GET/api/v1/deals

Query Parameters

8 parameters
pipeline_iduuid (query)required

Filter by pipeline UUID

stage_iduuid (query)required

Filter by stage UUID

product_iduuid (query)required

Filter by product UUID

statusstring (query)required

Filter: open, won, lost

owner_iduuid|string (query)required

Filter by owner UUID, or "unassigned"

phonestring (query)required

Filter by contact phone number

limitnumber (query)required

Max per page (default: 20)

offsetnumber (query)required

Pagination offset (default: 0)

Response Payload

200 OKapplication/json
statusstring

"1" = Success, "0" = Failure.

messageobject

The response data payload.

Code Snippets & Examples

1curl -X GET "https://app.chatofy.in/api/v1/deals?status=open&limit=20" \
2 -H "Authorization: Bearer YOUR_API_KEY"

Was this endpoint guide helpful?

Previous Endpoint
Archive Pipeline Stage
Next Endpoint
Create Deal
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X GET "https://app.chatofy.in/api/v1/deals?status=open&limit=20" \
2 -H "Authorization: Bearer YOUR_API_KEY"
200 OKapplication/json
1{
2 "success": true,
3 "data": [
4 {
5 "id": "d1111111-2222-3333-4444-555555555555",
6 "title": "Acme WhatsApp Migration",
7 "value": 120000,
8 "value_weighted": 84000,
9 "currency": "INR",
10 "status": "open",
11 "owner_id": "u1111111-2222-3333-4444-555555555555",
12 "expected_close_date": "2026-11-15",
13 "lost_reason": null,
14 "lost_at": null,
15 "created_at": "2026-10-26T10:00:00+05:30",
16 "contacts": {
17 "id": "c1111111-2222-3333-4444-555555555555",
18 "first_name": "Aarav",
19 "phone_number": "919876543210"
20 },
21 "pipeline_stages": {
22 "id": "s1111111-2222-3333-4444-555555555555",
23 "name": "Proposal Sent",
24 "color": "#f59e0b",
25 "kind": "open",
26 "probability": 70
27 },
28 "pipelines": {
29 "id": "p1111111-2222-3333-4444-555555555555",
30 "name": "Enterprise Sales"
31 }
32 }
33 ],
34 "message": "Deals retrieved successfully",
35 "pagination": {
36 "total": 1,
37 "limit": 20,
38 "offset": 0
39 }
40}