# Intent Leads

> B2B intent leads: people researching what you sell this week, with verified contact details. Dashboard, REST API, CLI and MCP.

- [Introduction](https://docs.intentleads.si/index.md): People researching what you sell, this week, with contact details you can use today.
- [Quickstart](https://docs.intentleads.si/quickstart.md): From an API key to a CSV of new leads in five calls.
- [Authentication](https://docs.intentleads.si/authentication.md): API keys, what standard and admin keys can do, and keeping them safe.
- [Lanes](https://docs.intentleads.si/guides/lanes.md): One lane is one audience: who you sell to, and what they're researching.
- [Keywords](https://docs.intentleads.si/guides/keywords.md): What your buyers research, and how a keyword goes live.
- [Checks and counts](https://docs.intentleads.si/guides/checks.md): How many people each lane has, at every filter step, for free.
- [Exports](https://docs.intentleads.si/guides/exports.md): Quote for free, confirm, and get new people. Nobody is billed twice in a period.
- [Leads](https://docs.intentleads.si/guides/leads.md): Get the people you've exported into your CRM, sequencer or dialler.
- [Plans and billing](https://docs.intentleads.si/guides/billing.md): You pay per person exported. Everything else is free.
- [Team](https://docs.intentleads.si/guides/team.md): Invite your team, and who can do what.
- [Removal requests](https://docs.intentleads.si/guides/suppressions.md): When someone asks to be removed, delete them from your systems within 10 business days.
- [CLI](https://docs.intentleads.si/cli.md): Export and pull leads from your terminal or a scheduled job.
- [MCP for AI agents](https://docs.intentleads.si/mcp-setup.md): Let Claude, Cursor or your own agent check lanes, quote and run exports.
- [Errors](https://docs.intentleads.si/errors.md): Every error code the API returns, and what to do about it.
- [Lead fields](https://docs.intentleads.si/lead-fields.md): Every field on a lead, in JSON and as a CSV column.
- [API overview](https://docs.intentleads.si/api-reference/introduction.md): Base URL, authentication, formats and conventions for the Intent Leads REST API.
- [List exports](https://docs.intentleads.si/api-reference/exports/list-exports.md): Your organization's exports, newest first (up to the latest 100), whoever started them. Reading an export never buys anything again; get its leads with `GET /api/v1/exports/{id}`.
- [Quote or start an export](https://docs.intentleads.si/api-reference/exports/quote-or-start-an-export.md): Quotes or starts an export of new people from one or more lanes.
- [Get an export and its leads](https://docs.intentleads.si/api-reference/exports/get-an-export-and-its-leads.md): One export and its leads, oldest first. Poll this after starting an export: while `status` is `queued` or `running`, `leads` holds only what's been written so far.
- [Pull or re-download leads](https://docs.intentleads.si/api-reference/leads/pull-or-re-download-leads.md): Leads you've already exported. Reading them never buys anything; to get new people, start an export with `POST /api/v1/exports`.
- [List deliveries](https://docs.intentleads.si/api-reference/leads/list-deliveries.md): Each export writes one delivery per lane it filled. Returns the latest 200, newest first. Get one delivery's leads with `GET /api/v1/leads?since=YYYY-MM-DD&delivery=ID`, using a `since` on or before its `delivered_on`.
- [List lanes](https://docs.intentleads.si/api-reference/lanes/list-lanes.md): Your lanes in priority order, with keyword counts and three kinds of numbers:
- [Create a lane](https://docs.intentleads.si/api-reference/lanes/create-a-lane.md): Creates a lane with the next free code (`L1`, `L2`, …) and sends each keyword for approval as its own topic. Approval usually takes about a day; once a keyword is live, people show up within 2 to 4 days. Nothing is bought until you export.
- [Get a lane](https://docs.intentleads.si/api-reference/lanes/get-a-lane.md): One lane in full: the counts from List lanes plus its audience, filters, every keyword (with its approval status and per-keyword counts) and the funnel.
- [Update a lane](https://docs.intentleads.si/api-reference/lanes/update-a-lane.md): Changes a lane's settings and filters. Fields you leave out keep their value; send `null` for `employees` to allow any size, or an empty list to clear a list filter. Returns the lane as Get a lane does.
- [Get a lane's sample](https://docs.intentleads.si/api-reference/lanes/get-a-lanes-sample.md): Up to 25 example people from the lane's latest checks: role, company and intent fields, plus whether an email, phone and LinkedIn are on file. No names or contact details.
- [Add a keyword](https://docs.intentleads.si/api-reference/keywords/add-a-keyword.md): Adds a keyword to a lane and sends it for approval as its own topic. `status` is `pending_approval` once it's sent, or `queued` if sending didn't go through yet (it's retried automatically).
- [Remove a keyword](https://docs.intentleads.si/api-reference/keywords/remove-a-keyword.md): Removes a keyword from a lane, matched on its exact text (case-insensitive). Checks and exports stop using it straight away; the lane's counts update at its next check.
- [List a lane's checks](https://docs.intentleads.si/api-reference/checks/list-a-lanes-checks.md): A check sizes a lane over a pinned 14-day data window: how many people pass each filter step, a sample, and per-keyword sizes. Lanes are checked automatically every day (final counts daily, the full funnel and keyword sizes about weekly).
- [Queue a lane check](https://docs.intentleads.si/api-reference/checks/queue-a-lane-check.md): Queues a fresh full check of one lane: the whole funnel, samples and per-keyword sizes. It takes minutes; poll `GET /api/v1/lanes/{code}/checks`.
- [Queue checks for every lane](https://docs.intentleads.si/api-reference/checks/queue-checks-for-every-lane.md): Queues a fresh full check for every lane that can be checked. Always returns `202` with one result per lane code: `queued`, `in_progress` (already running), `no_live_keywords`, `not_configured`, `no_data` or `failed`. Lanes that can't be checked are reported, not errors.
- [Refresh a lane's signals](https://docs.intentleads.si/api-reference/checks/refresh-a-lanes-signals.md): Picks up keyword approval decisions (pending keywords move to `live` or `rejected`) and refreshes the lane's quick one-day topic signals (`researching_latest_day`, for the lane and each live keyword). Both also happen automatically; call this when you want them now.
- [Get the company list](https://docs.intentleads.si/api-reference/company-list/get-the-company-list.md): Your organization's company list. There's one list, shared by every lane; each lane's `company_list_mode` decides how it's used (`narrow`, `replace` or `off`). `company_list` is null when nothing was uploaded. The entries themselves aren't returned.
- [Replace the company list](https://docs.intentleads.si/api-reference/company-list/replace-the-company-list.md): Replaces your company list; the previous one is deleted. Send either:
- [List suppressions](https://docs.intentleads.si/api-reference/suppressions/list-suppressions.md): People you exported who later asked to be removed. Under the data terms, delete them from your own systems (CRM, sequencer, spreadsheets) within 10 business days of `suppressed_at`.
- [Get usage](https://docs.intentleads.si/api-reference/usage/get-usage.md): Your plan and contacts this billing period. `allowance` is the plan's `monthly_contacts` plus `rollover_contacts` (last period's unused monthly contacts, kept for one period). `used` counts people exported this period; each person counts once per period.
- [Get billing](https://docs.intentleads.si/api-reference/billing/get-billing.md): Your plan, its status and period, usage (as in Get usage), every plan you can move to, and how you're billed.
- [Change plan](https://docs.intentleads.si/api-reference/billing/change-plan.md): Moves your organization to another plan: `starter`, `growth`, `scale` or `partner` (see `plans` in Get billing). What happens depends on how you're billed:
- [Get a billing portal link](https://docs.intentleads.si/api-reference/billing/get-a-billing-portal-link.md): A short-lived link to the billing portal, where an owner can see and download invoices, change the card or cancel. Only for plans paid by card; plans invoiced by DBEE get `409 no_billing_account`.
- [List members and invites](https://docs.intentleads.si/api-reference/team/list-members-and-invites.md): Everyone in your organization and every open invite link (not yet used, revoked or expired).
- [Create an invite link](https://docs.intentleads.si/api-reference/team/create-an-invite-link.md): Creates a single-use invite link that's valid for 14 days. Nothing is emailed: send the link yourself. `email` is a label shown on the Team page and isn't enforced, so whoever opens the link first can join with it. `role` defaults to `member`.
- [Revoke an invite link](https://docs.intentleads.si/api-reference/team/revoke-an-invite-link.md): Revokes an open invite link so it can't be used.
- [Remove a member](https://docs.intentleads.si/api-reference/team/remove-a-member.md): Removes someone from your organization. The last owner can't be removed. API keys belong to the organization, so they keep working.
- [Change a member's role](https://docs.intentleads.si/api-reference/team/change-a-members-role.md): Makes someone an `owner` or a `member`. The last owner can't be made a member.
- [List API keys](https://docs.intentleads.si/api-reference/api-keys/list-api-keys.md): Every API key in your organization, newest first, including revoked ones (`active: false`). Secrets are never returned.
- [Create an API key](https://docs.intentleads.si/api-reference/api-keys/create-an-api-key.md): Creates an API key. The full secret (`il_live_…`) is in `key` and is shown only once; only a hash is stored.
- [Revoke an API key](https://docs.intentleads.si/api-reference/api-keys/revoke-an-api-key.md): Revokes a key; it stops working at once. `revoked_self` is true when you revoked the key that made this call.
- [Rename a key or change its role](https://docs.intentleads.si/api-reference/api-keys/rename-a-key-or-change-its-role.md): Changes a key's `name`, `role` or both. You can change the key you're calling with; if you make it `standard`, it can't call admin endpoints any more.
- [Rotate an API key](https://docs.intentleads.si/api-reference/api-keys/rotate-an-api-key.md): Issues a new secret for a key, keeping its id, name and role. The old secret stops working at once, including when you rotate the key you're calling with. The new secret is shown only in this response.
- [Check a key](https://docs.intentleads.si/api-reference/account/check-a-key.md): Your organization's name and this key's role. A quick way to check that a key works.
- [List filter values](https://docs.intentleads.si/api-reference/reference/list-filter-values.md): Valid values for lane filters: every industry (for `industries` and `industries_exclude`), seniority levels, strengths and company-list modes. The example shows a few industries; the real list has a few hundred.
- [List activity](https://docs.intentleads.si/api-reference/activity/list-activity.md): Recent changes and events in your organization, newest first: keyword approvals, checks, exports, lane edits, company-list uploads, plan changes, keys, invites and team changes.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.