LiQ
Sign in
v1.0.0
OpenAPI 3.1.0

LeadIQ Pro Developer API

Authenticate every call with a Bearer API key you create in Settings → API. All endpoints share your dashboard's monthly quota and credit balances — no separate SKU, no new invoicing.

Client Libraries
Shell Curl

Developer API v1

​
Developer API v1 Operations

V1 Health

​

Liveness check — does not consume quota and does not require auth. Useful for CRM integration health checks.

Responses

  • application/json
Request Example for get/api/v1/health
curl /api/v1/health \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

null

Successful Response

Enrich a lead

​

Enrich a single lead. Default is async — returns {job_id,status} in <1s and (if callback_url is set) POSTs the full enriched payload to that URL on completion. Pass ?mode=sync to block up to ~90s and get the enriched lead inline.

Query Parameters

  • mode
    Type: string

Body·

required
application/json

Request body for POST /v1/leads/enrich. Attach a callback_url to turn the async flow into a webhook callback — LeadIQ will POST the enriched payload to that URL once the job completes.

  • lead
    Type:
    required

    A single lead to enrich. company and domain are required — everything else sharpens matching and personalization but isn't mandatory.

    Properties: 6
  • callback_url
    Type: stringnullable

    Webhook URL — if provided, LeadIQ Pro POSTs the enriched payload here when the job completes. Ignored for sync requests.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/v1/leads/enrich
curl '/api/v1/leads/enrich?mode=async' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "lead": {
    "name": "Jane Doe",
    "email": "jane@acme.com",
    "title": "VP of Marketing",
    "company": "Acme Corp",
    "domain": "acme.com",
    "linkedin_url": "https://linkedin.com/in/janedoe"
  },
  "callback_url": "https://yourapp.com/webhooks/leadiq"
}'

{
  "id": "string",
  "input": {
    "name": "Jane Doe",
    "email": "jane@acme.com",
    "title": "VP of Marketing",
    "company": "Acme Corp",
    "domain": "acme.com",
    "linkedin_url": "https://linkedin.com/in/janedoe"
  },
  "enrichment": {
    "company_overview": {
      "company_size": "string",
      "industry": "string",
      "summary": "string"
    },
    "tech_stack": {
      "cloud": [
        "string"
      ],
      "crm": [
        "string"
      ],
      "security": [
        "string"
      ],
      "infrastructure": [
        "string"
      ],
      "other": [
        "string"
      ]
    },
    "products": [
      "string"
    ],
    "intent_signals": {
      "hiring_signals": [
        "string"
      ],
      "recent_news": [
        "string"
      ],
      "content_published": [
        "string"
      ],
      "events_attended": [
        "string"
      ]
    },
    "buying_committee": [
      {
        "name": "string",
        "title": "string",
        "role": "string",
        "linkedin_url": "string"
      }
    ],
    "pain_points": [
      "string"
    ],
    "engagement_playbook": {
      "timing": "string",
      "opening_line": "string",
      "value_prop": "string",
      "case_study_angle": "string"
    },
    "opportunity_score": 0,
    "score_rationale": "string",
    "tags": [
      "string"
    ]
  },
  "tier": "string",
  "created_at": "string",
  "deduped": true,
  "message": "string"
}

Sync mode — the fully enriched lead.