List deals
Deals with title, customer, phase, estimated value and responsible user.
GET https://cotlet.dev/api/v1/teamleader/deals
read
Returns one page of deals, newest first. Filter by status, phase, customer or a search term. Each deal shows its current phase, the estimated closing date and the web link to the deal in Teamleader. Deals you cannot see with your user permissions are not returned.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | open, won or lost. Default: open. |
| phase_id string | string | Only deals in this phase, from list_deal_phases. |
| customer_id string | string | Only deals of this company, from search_companies. |
| term string | string | Search in title, reference and customer name. |
| page integer | integer | Page number, starting at 1. Default: 1. |
| page_size integer | integer | Items per page. Default: 20. |
Request
curl https://cotlet.dev/api/v1/teamleader/deals \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("teamleader", "list_deals")const result = await cotlet.call('teamleader', 'list_deals');cotlet call teamleader list_dealsExample response
{
"deals": [
{
"deal_id": "9c1f3a5e-7b24-4d68-8e0a-5f2b4c6d8e10",
"title": "Website redesign",
"customer": "Northwind Studio",
"phase": "Quotation sent",
"status": "open",
"estimated_value": {
"amount": 8400,
"currency": "EUR"
},
"estimated_closing_date": "2026-11-15",
"responsible_user": "Lotte Peeters"
}
],
"page": 1,
"total_matches": 1
}