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>"
}
}
}Deals
Get Deal
Retrieve a single deal by ID with all fields
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
The deal’s unique ID (UUID)
Headers
Authorization: Bearer wbk_your_api_key_here
Requires an API key with the
deals:read permission.Response
Show properties
Show properties
Show Deal object
Show Deal object
Unique deal ID (UUID)
Deal name / title
Current pipeline stage (e.g.,
qualification, proposal, closed_won)open, won, or lostPipeline slug the deal belongs to
Estimated deal value in the deal’s currency
ISO 4217 currency code (e.g.,
EUR, USD)UUID of the primary contact for this deal
UUID of the user who owns this deal
low, medium, high, or urgentType of legal matter (e.g.,
litigation, m&a, employment)Array of tag strings
UUID of the linked company, if any
Free-form description of the deal
ISO 8601 date of next scheduled follow-up
Fee structure (e.g.,
hourly, fixed, contingency, retainer)Win probability as an integer 0–100
ISO 8601 date the deal was closed (null if still open)
ISO 8601 timestamp when the deal was created
ISO 8601 timestamp of last update
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
| Status | Code | Description |
|---|---|---|
| 401 | invalid_key | Invalid or expired API key |
| 403 | insufficient_permissions | Missing deals:read permission |
| 404 | deal_not_found | No deal with this ID in your workspace |
| 429 | rate_limited | Rate limit exceeded |
⌘I