Skip to main content
GET
/
v1
/
deals
/
{id}
Get Deal
curl --request GET \
  --url https://api.example.com/v1/deals/{id}
{
  "data": {
    "deal": {
      "id": "<string>",
      "name": "<string>",
      "stage": "<string>",
      "status": "<string>",
      "pipeline": "<string>",
      "estimated_value": 123,
      "currency": "<string>",
      "main_contact_id": "<string>",
      "owner_user_id": "<string>",
      "priority": "<string>",
      "matter_type": "<string>",
      "tags": [
        {}
      ],
      "related_company_id": "<string>",
      "high_level_description": "<string>",
      "next_follow_up_date": "<string>",
      "fee_model": "<string>",
      "probability": 123,
      "closed_date": "<string>",
      "created_date": "<string>",
      "updated_date": "<string>"
    }
  }
}

Request

Path Parameters

id
string
required
The deal’s unique ID (UUID)

Headers

Authorization: Bearer wbk_your_api_key_here
Requires an API key with the deals:read permission.

Response

data
object
curl https://data.leadlex.com/functions/v1/api-gateway/v1/deals/3f8e1d2c-4b5a-6d7e-8f9a-0b1c2d3e4f5a \
  -H "Authorization: Bearer wbk_your_api_key_here"

Example Response

{
  "data": {
    "deal": {
      "id": "3f8e1d2c-4b5a-6d7e-8f9a-0b1c2d3e4f5a",
      "name": "Acme Corp — M&A Advisory",
      "stage": "proposal",
      "status": "open",
      "pipeline": "default",
      "estimated_value": 250000,
      "currency": "EUR",
      "main_contact_id": "123e4567-e89b-12d3-a456-426614174000",
      "owner_user_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
      "priority": "high",
      "matter_type": "m&a",
      "tags": ["cross-border", "strategic"],
      "related_company_id": "c1b2a3d4-e5f6-7890-abcd-ef1234567890",
      "high_level_description": "Advisory on proposed acquisition of subsidiary",
      "next_follow_up_date": "2026-04-22",
      "fee_model": "fixed",
      "probability": 60,
      "closed_date": null,
      "created_date": "2026-03-12T09:00:00Z",
      "updated_date": "2026-04-15T16:40:00Z"
    }
  }
}

Errors

StatusCodeDescription
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing deals:read permission
404deal_not_foundNo deal with this ID in your workspace
429rate_limitedRate limit exceeded