Developer docs

API documentation

Full REST API available on Growth, Scale, and Agency plans. Authenticate with your API key from the dashboard settings.

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key from Settings.

curl -X POST https://api.leadtyzer.com/v1/leads/search \
  -H "Authorization: Bearer lt_live_your_api_key" \
  -H "Content-Type: application/json"

Base URL:https://api.leadtyzer.com/v1

Endpoints

POST

/v1/leads/search

Submit a new lead order with targeting criteria. Returns an order_id immediately. Use GET /v1/leads/order/{id} to poll status.

GET

/v1/leads/order/{id}

Retrieve order status and leads once delivered. Includes ai_score per lead, email_verified status, and full contact data.

GET

/v1/leads/inventory

Check available verified lead inventory by sector and country before placing an order. Useful for instant delivery estimation.

POST

/v1/leads/single

Enrich a single domain or company - returns verified contacts at that company with AI scores.

GET

/v1/account/quota

Returns your current plan, monthly quota, used quota, remaining quota, and usage billing rate for extra leads.

DELETE

/v1/leads/{id}/optout

Permanently opt out a contact from your database and the LeadTYZER inventory. Required for GDPR compliance.

Standard response format

{
  "status": "success",
  "order_id": "ord_abc123",
  "leads": [
    {
      "company": {
        "name": "Acme Corp",
        "sector": "technology",
        "country": "GB",
        "size": "50-200",
        "website": "acme.com"
      },
      "contact": {
        "name": "Jane Smith",
        "title": "Head of Sales",
        "email": "j.smith@acme.com",
        "email_verified": true,
        "phone": "+44 20 1234 5678",
        "linkedin": "linkedin.com/in/janesmith"
      },
      "intelligence": {
        "ai_score": 87,
        "score_breakdown": { "seniority": 90, "data_freshness": 85 },
        "intent_signals": ["hiring", "funding_round"]
      }
    }
  ],
  "meta": {
    "total": 500,
    "avg_score": 84,
    "verified_rate": "100%",
    "delivery_seconds": 3600
  }
}

Need a custom integration?

Agency clients get a dedicated integration manager and custom SLA.