Pull or re-download leads

curl --request GET \
  --url https://intentleads.si/api/v1/leads \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://intentleads.si/api/v1/leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "since": "last",
  "lane": null,
  "count": 2,
  "has_more": false,
  "next_page": null,
  "leads": [
    {
      "lead_id": "0199e3b2-5a7c-7e21-b4d3-8c9f0a1b2c3d",
      "lane": "L1",
      "keywords_matched": [
        "selling to group purchasing organizations"
      ],
      "intent_strength": "high",
      "first_seen": "2026-10-03T00:00:00+00:00",
      "delivered_at": "2026-10-14T09:31:07.482913+00:00",
      "seen_before": false,
      "suppressed": false,
      "first_name": "Jordan",
      "last_name": "Lee",
      "job_title": "VP of Sales",
      "seniority": "VP",
      "company": "Acme Medical Supply",
      "website": "example.com",
      "industry": "Medical Equipment Manufacturing",
      "employees": 140,
      "city": "Minneapolis",
      "state": "MN",
      "business_email": "jordan.lee@example.com",
      "email_status": "valid",
      "mobile": "+1 612 555 0142",
      "mobile_on_dnc": false,
      "direct_phone": "+1 612 555 0187",
      "company_phone": "+1 612 555 0100",
      "linkedin": "linkedin.com/in/example-jordan-lee",
      "company_linkedin": "linkedin.com/company/example-acme-medical",
      "intent_topics": "selling to group purchasing organizations",
      "intent_score": 81,
      "last_active": "2026-10-12"
    },
    {
      "lead_id": "0199e3b2-5a7c-7e21-b4d3-8c9f0a1b2c3e",
      "lane": "L1",
      "keywords_matched": [
        "finding medical device distributors"
      ],
      "intent_strength": "medium",
      "first_seen": "2026-10-06T00:00:00+00:00",
      "delivered_at": "2026-10-14T09:31:07.482913+00:00",
      "seen_before": true,
      "suppressed": false,
      "first_name": "Sam",
      "last_name": "Rivera",
      "job_title": "Director of Business Development",
      "seniority": "Director",
      "company": "Globex Surgical",
      "website": "example.org",
      "industry": "Medical Device",
      "employees": 85,
      "city": "Columbus",
      "state": "OH",
      "business_email": "sam.rivera@example.org",
      "email_status": "valid",
      "mobile": null,
      "mobile_on_dnc": null,
      "direct_phone": "+1 614 555 0133",
      "company_phone": "+1 614 555 0100",
      "linkedin": "linkedin.com/in/example-sam-rivera",
      "company_linkedin": "linkedin.com/company/example-globex-surgical",
      "intent_topics": "finding medical device distributors",
      "intent_score": 54,
      "last_active": "2026-10-11"
    }
  ]
}

Pull or re-download leads

Leads you’ve already exported. Reading them never buys anything; to get new people, start an export with POST /api/v1/exports.

since=last (default): pull what’s new. Returns the leads this consumer hasn’t pulled yet, oldest first, and moves its server-side cursor past them, so a daily job never sees the same lead twice. If has_more is true, call again straight away. Each consumer has its own cursor, and so does each consumer and lane pair: pulling with lane=L1 doesn’t move the all-lanes cursor (or the other way round), so a job that uses both gets L1’s leads twice.

since=YYYY-MM-DD: re-download. Every lead exported on or after that date (UTC), oldest first, without touching any cursor. Narrow it with to, lane, delivery, strength and keyword, and page with next_page (X-Next-Page for CSV).

Good to know

The cursor moves as soon as the response is built. If your job fails after the call, recover that batch with since=YYYY-MM-DD.
to, delivery, strength, keyword and page only apply with a date since; with since=last they’re ignored. Values that don’t parse are ignored too.
Suppressed people come back with suppressed: true and empty contact fields.

CSV: add format=csv for a file, with the headers X-Lead-Count, X-Has-More and (date mode) X-Next-Page. The CSV has one header row and these columns, in this order: First Name, Last Name, Job Title, Seniority, Company, Website, Industry, Employees, City, State, Business Email, Email Status, Mobile, Mobile on DNC, Direct Phone, Company Phone, LinkedIn, Company LinkedIn, Intent Topics, Intent Score, Last Active, Lane, Keywords Matched, Intent Strength, First Seen, Exported, Seen Before, Suppressed, Lead ID. Exported is delivered_at. Lists (Keywords Matched) are joined with ; , booleans are Yes or No, empty values are empty cells, and lines end with CRLF. Cells that start with =, +, -, @ or a tab are prefixed with ' so spreadsheets don’t run them as formulas (phone numbers like +1 612 555 0142 are left as they are).

Free. This doesn’t use any contacts from your plan.

GET

api

leads

Pull or re-download leads

curl --request GET \
  --url https://intentleads.si/api/v1/leads \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://intentleads.si/api/v1/leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "since": "last",
  "lane": null,
  "count": 2,
  "has_more": false,
  "next_page": null,
  "leads": [
    {
      "lead_id": "0199e3b2-5a7c-7e21-b4d3-8c9f0a1b2c3d",
      "lane": "L1",
      "keywords_matched": [
        "selling to group purchasing organizations"
      ],
      "intent_strength": "high",
      "first_seen": "2026-10-03T00:00:00+00:00",
      "delivered_at": "2026-10-14T09:31:07.482913+00:00",
      "seen_before": false,
      "suppressed": false,
      "first_name": "Jordan",
      "last_name": "Lee",
      "job_title": "VP of Sales",
      "seniority": "VP",
      "company": "Acme Medical Supply",
      "website": "example.com",
      "industry": "Medical Equipment Manufacturing",
      "employees": 140,
      "city": "Minneapolis",
      "state": "MN",
      "business_email": "jordan.lee@example.com",
      "email_status": "valid",
      "mobile": "+1 612 555 0142",
      "mobile_on_dnc": false,
      "direct_phone": "+1 612 555 0187",
      "company_phone": "+1 612 555 0100",
      "linkedin": "linkedin.com/in/example-jordan-lee",
      "company_linkedin": "linkedin.com/company/example-acme-medical",
      "intent_topics": "selling to group purchasing organizations",
      "intent_score": 81,
      "last_active": "2026-10-12"
    },
    {
      "lead_id": "0199e3b2-5a7c-7e21-b4d3-8c9f0a1b2c3e",
      "lane": "L1",
      "keywords_matched": [
        "finding medical device distributors"
      ],
      "intent_strength": "medium",
      "first_seen": "2026-10-06T00:00:00+00:00",
      "delivered_at": "2026-10-14T09:31:07.482913+00:00",
      "seen_before": true,
      "suppressed": false,
      "first_name": "Sam",
      "last_name": "Rivera",
      "job_title": "Director of Business Development",
      "seniority": "Director",
      "company": "Globex Surgical",
      "website": "example.org",
      "industry": "Medical Device",
      "employees": 85,
      "city": "Columbus",
      "state": "OH",
      "business_email": "sam.rivera@example.org",
      "email_status": "valid",
      "mobile": null,
      "mobile_on_dnc": null,
      "direct_phone": "+1 614 555 0133",
      "company_phone": "+1 614 555 0100",
      "linkedin": "linkedin.com/in/example-sam-rivera",
      "company_linkedin": "linkedin.com/company/example-globex-surgical",
      "intent_topics": "finding medical device distributors",
      "intent_score": 54,
      "last_active": "2026-10-11"
    }
  ]
}

Authorizations

Authorization

string

header

required

An Intent Leads API key, e.g. il_live_ followed by 32 letters and digits. Create one on the API and CLI page of the dashboard.

Query Parameters

since

string

default:last

last (default): new leads since this consumer's last pull, moving its cursor. Or a date YYYY-MM-DD: everything exported since then (UTC), no cursor change.

lane

string

Only this lane's leads (case-insensitive). With since=last the lane has its own cursor.

consumer

string

default:default

Names the cursor for since=last, so separate jobs each get every lead. Letters, digits, ., - or _, up to 40.

Pattern: ^[A-Za-z0-9_.-]{1,40}$

limit

integer

default:1000

Leads per response, 1 to 5,000. Out-of-range values are clamped.

Required range: 1 <= x <= 5000

format

enum<string>

default:json

json (default) or csv.

Available options:

json,

csv

page

string

Date mode only: the next_page value from the previous response.

string<date>

Date mode only: last export date to include (YYYY-MM-DD, UTC, inclusive).

delivery

integer

Date mode only: only leads from this delivery id (see GET /api/v1/deliveries).

Required range: x >= 1

strength

enum<string>

Date mode only: medium (medium and high) or high (high only). Other values are ignored.

Available options:

medium,

high

keyword

string

Date mode only: only leads that matched this exact keyword (case-sensitive).

Response

A page of leads, as JSON or (with format=csv) a CSV file.

since

string

required

The since you sent: last or a date.

Example:

"last"

lane

string | null

required

Lane filter, or null for every lane.

count

integer

required

Leads in this response.

has_more

boolean

required

True when this response is full (count equals limit): call again for more.

next_page

string | null

required

Only with since=YYYY-MM-DD: pass as page to get the next page. Null when there are no more, and always null with since=last.

leads

object[]

required

Show child attributes

Overview

Endpoints

Pull or re-download leads

Authorizations

Query Parameters

Response