Skip to main content
POST
/
v1
/
ai
/
discover-conferences
Discover Conferences
curl --request POST \
  --url https://api.example.com/v1/ai/discover-conferences \
  --header 'Content-Type: application/json' \
  --data '
{
  "industry": "<string>",
  "region": "<string>",
  "date_range": {},
  "topics": [
    {}
  ],
  "limit": 123
}
'
{
  "data": {
    "conferences": [
      {
        "name": "<string>",
        "url": "<string>",
        "start_date": "<string>",
        "end_date": "<string>",
        "location": "<string>",
        "industry_tags": [
          {}
        ],
        "topics": [
          {}
        ],
        "relevance": 123,
        "attendee_size": "<string>",
        "reason": "<string>"
      }
    ],
    "generated_at": "<string>",
    "cache_hit": true,
    "credits_remaining": 123
  }
}
This endpoint consumes 3 AI credits per call. Results are cached per workspace for 24 hours keyed on the request parameters. If the workspace balance is insufficient, the API returns 402 insufficient_credits.

Request

Headers

Authorization: Bearer wbk_your_api_key_here
Content-Type: application/json
Idempotency-Key
string
Optional UUID for retry deduplication.

Body Parameters

industry
string
Industry focus (e.g. legal-tech, private-equity, life-sciences). Defaults to the workspace’s configured industry.
region
string
Region filter: global, europe, north-america, apac, or an ISO 3166-1 alpha-2 country code.
date_range
object
Optional { from, to } window in ISO 8601 dates. Defaults to the next 180 days.
topics
array
Optional array of topical keywords to match against conference tracks.
limit
integer
default:"20"
Maximum number of conferences to return. Maximum 100.

Response

data
object
Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-Request-ID.
curl -X POST \
  https://data.leadlex.com/functions/v1/api-gateway/v1/ai/discover-conferences \
  -H "Authorization: Bearer wbk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"industry": "legal-tech", "region": "europe", "limit": 10}'

Example Response

{
  "data": {
    "conferences": [
      {
        "name": "Legal Innovators London",
        "url": "https://legalinnovators.co.uk",
        "start_date": "2026-06-09",
        "end_date": "2026-06-10",
        "location": "London, UK",
        "industry_tags": ["legal-tech"],
        "topics": ["ai", "innovation", "gc"],
        "relevance": 0.92,
        "attendee_size": "500-2000",
        "reason": "Flagship UK legal-tech event; several workspace contacts historically attend."
      }
    ],
    "generated_at": "2026-04-17T10:45:00Z",
    "cache_hit": false,
    "credits_remaining": 4848
  }
}

Errors

StatusCodeDescription
400validation_errorInvalid region, date_range, or limit
401invalid_keyInvalid or expired API key
402insufficient_creditsWorkspace credit balance is exhausted
403insufficient_permissionsMissing write:ai permission
429rate_limitedRate limit exceeded