Get deal

One deal with its phase, customer, contact person, value and quotations.

GET https://cotlet.dev/api/v1/teamleader/deals/{deal_id}

read

Returns one deal with its current phase, customer, contact person, estimated value and probability, the responsible user and every quotation on it with its status. Use it to check whether another quotation on the deal is already accepted.

Parameters

Parameters: get_deal
NameTypeDescription
deal_id string required string Deal ID from list_deals.

Request

cURL
curl https://cotlet.dev/api/v1/teamleader/deals/deal_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("teamleader", "get_deal", {"deal_id":"deal_8c41d2"})
Node.js
const result = await cotlet.call('teamleader', 'get_deal', {"deal_id":"deal_8c41d2"});
CLI
cotlet call teamleader get_deal --data '{"deal_id":"deal_8c41d2"}'

Example response

JSON

{
  "deal_id": "9c1f3a5e-7b24-4d68-8e0a-5f2b4c6d8e10",
  "title": "Website redesign",
  "customer": "Northwind Studio",
  "contact_person": "Jonas Willems",
  "phase": "Quotation sent",
  "status": "open",
  "estimated_value": {
    "amount": 8400,
    "currency": "EUR"
  },
  "responsible_user": "Lotte Peeters",
  "quotations": [
    {
      "quotation_id": "e3b1c7a9-4d52-4086-b7f1-2a9c5d8e0f34",
      "status": "sent",
      "sent_at": "2026-10-08T09:12:00Z",
      "total_excl_tax": {
        "amount": 8400,
        "currency": "EUR"
      }
    }
  ],
  "web_url": "https://focus.teamleader.eu/sale_detail.php?id=9c1f3a5e-7b24-4d68-8e0a-5f2b4c6d8e10"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.