What authentication does the API use?

Bearer token authentication. Generate API keys from the dashboard, include them as Authorization: Bearer {key} headers. Keys support per-endpoint scoping and rate limit customization.

What are the API rate limits?

Rate limits depend on your plan: Starter (100 req/min), Professional (500 req/min), Enterprise (custom). All responses include X-RateLimit-Remaining and X-RateLimit-Reset headers.

Python and Node.js SDKs are available. Both wrap the REST API with typed responses, automatic pagination, retry logic, and batch helpers.

Can I use webhooks for real-time updates?

Yes. Register webhook endpoints for events: pipeline.completed, verification.completed, email.bounced, campaign.paused. All webhooks include signature verification headers.

API & Developer Platform - Sales Intelligence API

Interactive Quick Start

Build a request before reading the whole reference

Choose a workflow, adjust request options, copy SDK-ready code, and inspect the response contract, headers, limits, and webhook behavior.

p95 uptime

99.95%

sandbox

free

version

POST/v1/leads/search

Find verified decision makers by title, industry, geography, technology, and intent.

API keyLimit

curl -X POST "https://sandbox.api.leadslogix.com/v1/leads/search" \
  -H "Authorization: Bearer llx_sk_test_123456789" \
  -H "Content-Type: application/json" \
  -H "X-Organization-Id: org_01JY8QZ5T8" \
  -d '{"filters":{"titles":["VP Sales","Head of Revenue","RevOps Director"],"industries":["Software","B2B SaaS"],"employees":{"min":50,"max":1000},"technologies":["Salesforce","HubSpot"],"has_verified_email":true,"include_phone":false},"limit":25,"sort":"confidence_desc"}'

Base URL

https://sandbox.api.leadslogix.com

Credits

1 credit / 25 previews

Latency

280 ms p50

Org header

X-Organization-Id

Response Preview

Status, headers, payload shape.

200 OK

Request ID

req_8QZ5T8

Remaining

4,982

Reset

42s

JSON

{
  "object": "lead_search_result",
  "data": [
    {
      "id": "lead_01JY8R6P7N6K3",
      "name": "Maya Chen",
      "title": "VP Sales",
      "company": "Northstar Cloud",
      "verified_email": "maya.chen@northstarcloud.com",
      "phone": null,
      "confidence": 96,
      "source_count": 4
    }
  ],
  "page": {
    "limit": 25,
    "next_cursor": "cur_eyJvZmZzZXQiOjI1fQ"
  },
  "credits_used": 1
}

Endpoint Parameters

filtersobject *

Structured company and contact filters.

limitinteger

Records returned per page. Max 100.

cursorstring

Opaque cursor from the previous response.

Reference Details

Authentication contract

Use Bearer API keys generated from the dashboard.
Scope keys by environment, organization, and action.
Rotate keys without interrupting existing webhook subscriptions.

Authorization: Bearer llx_sk_live_...
X-Organization-Id: org_01JY8QZ5T8
Content-Type: application/json

Rate-limit headers

Every response includes remaining quota, reset time, and request id for support traceability.

X-RateLimit-Remaining: 4982

Webhook signing

Callbacks include a timestamp and HMAC signature. Reject events older than five minutes.

X-LLX-Signature: sha256=...

Tenant scope

Use organization headers for team accounts. API keys can be scoped to search, export, billing, or admin actions.

X-Organization-Id: org_...

Detailed API Contract

Reference the field model, scopes, response codes, webhook event catalog, SDK setup, and request lifecycle used across LeadsLogix API endpoints.

Applies to REST API v1

lead

7 fields

idstringrequired

Stable LeadsLogix lead identifier.

person.namestringrequired

Normalized full name from source evidence.

person.titlestringrequired

Current title with seniority and department inference.

company.domainstringrequired

Official company domain used for dedupe and enrichment.

email.valuestring | null

Verified email when revealed or included by plan.

email.statusenum

deliverable, risky, unknown, undeliverable.

confidencenumberrequired

0-100 composite score across identity, source, and freshness.

company

6 fields

idstringrequired

Stable company identifier.

domainstringrequired

Canonical official website domain.

industrystring

Primary normalized industry label.

employeesinteger

Estimated headcount when available.

technologiesarray

Detected CRM, analytics, ads, data, CMS, and infra tools.

intent_signalsarray

Hiring, funding, tech migration, and market activity signals.

pipeline_job

5 fields

idstringrequired

Async job id used for polling and webhook correlation.

statusenumrequired

queued, running, completed, failed, paused.

stagesarrayrequired

Stage-level status, record counts, credits, errors, and duration.

credits_estimatedinteger

Estimated cost before execution.

credits_spentinteger

Final metered credits after completion.

API Endpoints

Explore available endpoints. Filter by method, search by path.

POST/api/v1/enrichRun enrichment pipeline on a company. Returns contacts, emails, social profiles.

POST/api/v1/discoverDiscover emails for a domain using the 4-layer discovery pipeline.

GET/api/v1/company/{domain}Get enriched company profile by domain. Includes contacts, tech stack, social.

POST/api/v1/leads/searchSearch your lead database by company, domain, industry, location, or enrichment status.

FAQ

Frequently Asked Questions

Everything you need to know about our platform.

Still have questions?

Our team can walk you through the pipeline, pricing, and your use case.

Talk to us

API Documentation

Resource

Full API reference and guides

/resources/api-docs

Platform Architecture

Platform

Understand the pipeline

/platform

Integrations

Integration

Pre-built connections

/integrations

Enterprise Security

Security

API security and trust controls

/security

Interactive Quick Start

Build a request before reading the whole reference

Choose a workflow, adjust request options, copy SDK-ready code, and inspect the response contract, headers, limits, and webhook behavior.

p95 uptime

99.95%

sandbox

free

version

POST/v1/leads/search

Find verified decision makers by title, industry, geography, technology, and intent.

API keyLimit

curl -X POST "https://sandbox.api.leadslogix.com/v1/leads/search" \
  -H "Authorization: Bearer llx_sk_test_123456789" \
  -H "Content-Type: application/json" \
  -H "X-Organization-Id: org_01JY8QZ5T8" \
  -d '{"filters":{"titles":["VP Sales","Head of Revenue","RevOps Director"],"industries":["Software","B2B SaaS"],"employees":{"min":50,"max":1000},"technologies":["Salesforce","HubSpot"],"has_verified_email":true,"include_phone":false},"limit":25,"sort":"confidence_desc"}'

Base URL

https://sandbox.api.leadslogix.com

Credits

1 credit / 25 previews

Latency

280 ms p50

Org header

X-Organization-Id

Response Preview

Status, headers, payload shape.

200 OK

Request ID

req_8QZ5T8

Remaining

4,982

Reset

42s

JSON

{
  "object": "lead_search_result",
  "data": [
    {
      "id": "lead_01JY8R6P7N6K3",
      "name": "Maya Chen",
      "title": "VP Sales",
      "company": "Northstar Cloud",
      "verified_email": "maya.chen@northstarcloud.com",
      "phone": null,
      "confidence": 96,
      "source_count": 4
    }
  ],
  "page": {
    "limit": 25,
    "next_cursor": "cur_eyJvZmZzZXQiOjI1fQ"
  },
  "credits_used": 1
}

Endpoint Parameters

filtersobject *

Structured company and contact filters.

limitinteger

Records returned per page. Max 100.

cursorstring

Opaque cursor from the previous response.

Reference Details

Authentication contract

Use Bearer API keys generated from the dashboard.
Scope keys by environment, organization, and action.
Rotate keys without interrupting existing webhook subscriptions.

Authorization: Bearer llx_sk_live_...
X-Organization-Id: org_01JY8QZ5T8
Content-Type: application/json

Rate-limit headers

Every response includes remaining quota, reset time, and request id for support traceability.

X-RateLimit-Remaining: 4982

Webhook signing

Callbacks include a timestamp and HMAC signature. Reject events older than five minutes.

X-LLX-Signature: sha256=...

Tenant scope

Use organization headers for team accounts. API keys can be scoped to search, export, billing, or admin actions.

X-Organization-Id: org_...

Detailed API Contract

Reference the field model, scopes, response codes, webhook event catalog, SDK setup, and request lifecycle used across LeadsLogix API endpoints.

Applies to REST API v1

lead

7 fields

idstringrequired

Stable LeadsLogix lead identifier.

person.namestringrequired

Normalized full name from source evidence.

person.titlestringrequired

Current title with seniority and department inference.

company.domainstringrequired

Official company domain used for dedupe and enrichment.

email.valuestring | null

Verified email when revealed or included by plan.

email.statusenum

deliverable, risky, unknown, undeliverable.

confidencenumberrequired

0-100 composite score across identity, source, and freshness.

company

6 fields

idstringrequired

Stable company identifier.

domainstringrequired

Canonical official website domain.

industrystring

Primary normalized industry label.

employeesinteger

Estimated headcount when available.

technologiesarray

Detected CRM, analytics, ads, data, CMS, and infra tools.

intent_signalsarray

Hiring, funding, tech migration, and market activity signals.

pipeline_job

5 fields

idstringrequired

Async job id used for polling and webhook correlation.

statusenumrequired

queued, running, completed, failed, paused.

stagesarrayrequired

Stage-level status, record counts, credits, errors, and duration.

credits_estimatedinteger

Estimated cost before execution.

credits_spentinteger

Final metered credits after completion.

API Endpoints

Explore available endpoints. Filter by method, search by path.

POST/api/v1/enrichRun enrichment pipeline on a company. Returns contacts, emails, social profiles.

POST/api/v1/discoverDiscover emails for a domain using the 4-layer discovery pipeline.

GET/api/v1/company/{domain}Get enriched company profile by domain. Includes contacts, tech stack, social.

POST/api/v1/leads/searchSearch your lead database by company, domain, industry, location, or enrichment status.

FAQ

Frequently Asked Questions

Everything you need to know about our platform.

Still have questions?

Our team can walk you through the pipeline, pricing, and your use case.

Talk to us

API Documentation

Resource

Full API reference and guides

/resources/api-docs

Platform Architecture

Platform

Understand the pipeline

/platform

Integrations

Integration

Pre-built connections

/integrations

Enterprise Security

Security

API security and trust controls

/security

Build a request before reading the whole reference

Response Preview

Endpoint Parameters

Reference Details

Authentication contract

Rate-limit headers

Webhook signing

Tenant scope

Detailed API Contract

lead

company

pipeline_job

API Endpoints

Research & Enrichment

Email Verification

Export & Webhooks

Frequently Asked Questions

Related

API Documentation

Platform Architecture

Integrations

Enterprise Security

Build a request before reading the whole reference

Response Preview

Endpoint Parameters

Reference Details

Authentication contract

Rate-limit headers

Webhook signing

Tenant scope

Detailed API Contract

lead

company

pipeline_job

API Endpoints

Research & Enrichment

Email Verification

Export & Webhooks

Frequently Asked Questions

Related

API Documentation

Platform Architecture

Integrations

Enterprise Security