Skip to main content
GET
/
v1
/
deals
List Deals
curl --request GET \
  --url https://api.example.com/v1/deals
{
  "data": {
    "deals": [
      {
        "id": "<string>",
        "name": "<string>",
        "stage": "<string>",
        "status": "<string>",
        "pipeline": "<string>",
        "estimated_value": 123,
        "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,
        "currency": "<string>",
        "closed_date": "<string>",
        "created_date": "<string>",
        "updated_date": "<string>"
      }
    ]
  },
  "meta": {
    "page": 123,
    "per_page": 123,
    "total": 123
  }
}

Request

Query Parameters

page
integer
default:"1"
Page number for pagination
per_page
integer
default:"50"
Number of deals per page (max: 100)
status
string
Filter by status (e.g., active, won, lost)
pipeline
string
Filter by pipeline name
stage
string
Filter by stage name
contact_id
string
Filter by main contact ID
owner_user_id
string
Filter by deal owner user ID
tags
string
Filter by tag
created_after
string
Filter deals created after this date (ISO 8601)
created_before
string
Filter deals created before this date (ISO 8601)
updated_after
string
Filter deals updated after this date (ISO 8601)

Headers

Authorization: Bearer wbk_your_api_key_here

Response

data
object
meta
object
Pagination metadata
curl https://data.leadlex.com/functions/v1/api-gateway/v1/deals \
  -H "Authorization: Bearer wbk_your_api_key_here"

Example Response

{
  "data": {
    "deals": [
      {
        "id": "deal-001",
        "name": "Acme Corp Partnership",
        "stage": "Proposal",
        "status": "active",
        "pipeline": "Sales",
        "estimated_value": 50000,
        "main_contact_id": "contact-001",
        "owner_user_id": "user-001",
        "priority": "high",
        "matter_type": "partnership",
        "tags": ["enterprise"],
        "probability": 60,
        "currency": "USD",
        "created_date": "2026-03-01T10:00:00Z",
        "updated_date": "2026-03-05T14:00:00Z"
      }
    ]
  },
  "meta": { "page": 1, "per_page": 50, "total": 23 }
}

Errors

StatusCodeDescription
401invalid_keyInvalid or expired API key
403insufficient_permissionsMissing deals:read permission
429rate_limitedRate limit exceeded