> ## Documentation Index > Fetch the complete documentation index at: https://docs.intentleads.si/llms.txt > Use this file to discover all available pages before exploring further. # List a lane's checks > 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). Returns the check in progress (or null) and finished checks with results, newest first. **Free.** This doesn't use any contacts from your plan. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/lanes/{code}/checks openapi: 3.1.0 info: title: Intent Leads API version: '1.0' description: >- The Intent Leads API finds B2B people actively researching the topics you sell into, and exports them with contact details into your own tools. **Authentication.** Send an API key as a bearer token: `Authorization: Bearer il_live_…`. Keys belong to one organization. Standard keys work with everything except billing, team and key management, which need an admin key. **What costs contacts.** Only `POST /api/v1/exports` with `"dry_run": false` uses contacts from your plan. Quotes, counts, checks, samples and re-downloads are free. **Errors.** Every error is JSON: `{"error": "code", "message": "Plain-English explanation"}`. Codes are stable; messages may change. **Conventions.** JSON by default. Dates are `YYYY-MM-DD` and timestamps ISO 8601, all in UTC. Lane codes (`L1`) are case-insensitive. servers: - url: https://intentleads.si security: - bearerAuth: [] tags: - name: Exports description: Quote (free) and buy new people from your lanes, then download them. - name: Leads description: Pull and re-download the leads you've exported, and list deliveries. - name: Lanes description: >- Create, inspect and tune lanes: keywords plus the companies and roles you want. - name: Keywords description: Add and remove a lane's keywords; each one is approved as its own topic. - name: Checks description: >- Free lane checks that size every filter step over 14 days, plus quick topic signals. - name: Company list description: >- The target-company list your lanes can narrow to or use instead of industries. - name: Suppressions description: People you exported who later asked to be removed. - name: Usage description: Contacts used and left this billing period. - name: Billing description: Plan, invoices and plan changes. Admin keys only. - name: Team description: Members and invite links. Admin keys only. - name: API keys description: Create, rename, rotate and revoke API keys. Admin keys only. - name: Account description: Check which organization a key belongs to and its role. - name: Reference description: Valid values for lane filters. - name: Activity description: A feed of changes and events in your organization. paths: /api/v1/lanes/{code}/checks: get: tags: - Checks summary: List a lane's checks description: >- 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). Returns the check in progress (or null) and finished checks with results, newest first. **Free.** This doesn't use any contacts from your plan. operationId: listLaneChecks parameters: - $ref: '#/components/parameters/LaneCode' responses: '200': description: The lane's checks. content: application/json: schema: type: object properties: lane: type: string in_progress: description: The check running now, or null. anyOf: - type: object properties: status: type: string enum: - queued - running done: type: integer description: Counts finished (including ones that failed). total: type: integer description: Counts in this check. data_window: $ref: '#/components/schemas/DataWindow' required: - status - done - total - data_window - type: 'null' checks: type: array items: $ref: '#/components/schemas/CheckRun' description: Finished checks, newest first. required: - lane - in_progress - checks example: lane: L1 in_progress: status: running done: 7 total: 19 data_window: start: '2026-10-01' end: '2026-10-14' checks: - checked_at: '2026-10-14T06:12:41.528311+00:00' status: completed kind: daily_finals data_window: start: '2026-09-30' end: '2026-10-13' industry_final: all: 1265 medium_plus: 412 company_list_final: null both_final: null counts_missing: 0 '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/LaneNotFound' '500': $ref: '#/components/responses/InternalError' components: parameters: LaneCode: name: code in: path required: true description: Lane code, e.g. `L1`. Case-insensitive. schema: type: string example: L1 schemas: DataWindow: type: object properties: start: type: string format: date description: First data day (inclusive), UTC. end: type: string format: date description: Last data day (inclusive), UTC. required: - start - end description: >- The 14-day data window a count covers. It can be shorter when fewer consecutive data days are ready. example: start: '2026-09-30' end: '2026-10-13' CheckRun: type: object properties: checked_at: type: - string - 'null' format: date-time description: When the check finished. status: type: string enum: - completed - partial - failed description: '`partial` means some counts couldn''t be sized (`counts_missing`).' kind: type: string enum: - full - daily_finals - company_list_only description: >- `full`: the whole funnel, samples and keyword sizes. `daily_finals`: final counts only. `company_list_only`: only the company-list path. data_window: $ref: '#/components/schemas/DataWindow' industry_final: anyOf: - $ref: '#/components/schemas/CheckCounts' - type: 'null' description: Final count on the industry path. company_list_final: anyOf: - $ref: '#/components/schemas/CheckCounts' - type: 'null' description: >- Final count on the company-list path, or null without a company list. both_final: anyOf: - $ref: '#/components/schemas/CheckCounts' - type: 'null' description: >- Final count with industries and the company list together (`narrow` lanes), or null. counts_missing: type: integer description: Counts in this check that couldn't be sized. required: - checked_at - status - kind - data_window - industry_final - company_list_final - both_final - counts_missing CheckCounts: type: object properties: all: type: - integer - 'null' medium_plus: type: - integer - 'null' high: type: - integer - 'null' description: Present only when the check sized it. required: - all - medium_plus Error: type: object properties: error: type: string example: lane_not_found description: Stable machine-readable code, e.g. `lane_not_found`. message: type: string example: No lane L9. description: Plain-English explanation you can show to a person. required: - error - message description: Every error has this shape. responses: Unauthorized: description: Missing, malformed, unknown or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: unauthorized: value: error: unauthorized message: 'Send a valid API key as: Authorization: Bearer il_live_…' LaneNotFound: description: No lane with that code. content: application/json: schema: $ref: '#/components/schemas/Error' examples: lane_not_found: value: error: lane_not_found message: No lane L9. InternalError: description: >- Unexpected server error. Safe to retry reads; retry an export only with the same `idempotency_key`. content: application/json: schema: $ref: '#/components/schemas/Error' examples: internal_error: value: error: internal_error message: Something went wrong. Try again. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: il_live_… description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.