GET/v1/sources

List sources

Every dataset behind /v1/find, with row counts and per-source filter compatibility.

Use this to discover what's queryable and how. Each source declares which filters it supports, whether the column is case-sensitive, whether it has a fast path (typically company_domain), and whether the match is exact or ilike_contains.

The response also includes the canonical filter list and the narrowing-filter set - everything you need to drive client-side validation. Cache the response for ~1 hour; the gateway sets the headers for you.

Example request

curl -H "Authorization: Bearer $LEADLEAP_KEY" \
  https://data.leadleap.net/v1/sources

Example response

{
  "sources": [
    {
      "id": "leadleap_contacts",
      "display_name": "LeadLeap Contacts",
      "type": "contacts",
      "row_count_approx": 28346418,
      "supported_filters": {
        "country":         {"supported": true, "case_sensitive": true},
        "state":           {"supported": true, "case_sensitive": true},
        "industry":        {"supported": true, "case_sensitive": true},
        "company_domain":  {"supported": true, "fast_path": true},
        "company_name":    {"supported": true, "match": "ilike_contains"},
        "title":           {"supported": true, "match": "ilike_contains"},
        "job_level":       {"supported": true, "case_sensitive": false},
        "has_email":       {"supported": true},
        "has_phone":       {"supported": true},
        "has_linkedin":    {"supported": true}
      }
    },
    { "id": "leadleap_companies", "row_count_approx": 1810029, "...": "..." },
    { "id": "us_healthcare_providers", "row_count_approx": 9321586, "...": "..." },
    { "id": "uk_companies_house",      "row_count_approx": 5667074, "...": "..." }
    // ...remainder of the catalog
  ],
  "canonical_filters": ["country","state","industry","company_domain","company_name",
                        "title","department","job_level","size_range","gender",
                        "year_founded_min","year_founded_max","employee_count_min",
                        "employee_count_max","income_range",
                        "has_email","has_phone","has_linkedin"],
  "narrowing_filters": ["size_range","company_domain","title","gender","company_name",
                        "country","job_level","state","industry","department"]
}