> ## 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. # Get a lane's sample > 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. Rows are at the lane's own strength. If nobody passes at that strength yet, rows at any strength are shown with `below_lane_strength: true`. Samples come from checks; queue a fresh one with `POST /api/v1/lanes/{code}/checks`. Values are as stored, so text is often lowercase. **Free.** This doesn't use any contacts from your plan. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/lanes/{code}/sample 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}/sample: get: tags: - Lanes summary: Get a lane's sample description: >- 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. Rows are at the lane's own strength. If nobody passes at that strength yet, rows at any strength are shown with `below_lane_strength: true`. Samples come from checks; queue a fresh one with `POST /api/v1/lanes/{code}/checks`. Values are as stored, so text is often lowercase. **Free.** This doesn't use any contacts from your plan. operationId: getLaneSample parameters: - $ref: '#/components/parameters/LaneCode' responses: '200': description: The sample. content: application/json: schema: $ref: '#/components/schemas/Sample' example: lane: L1 status: ready checked_at: '2026-10-14T06:12:41.528311+00:00' data_window: start: '2026-09-30' end: '2026-10-13' min_strength: medium filters_used: industries sample_strength: medium_plus below_lane_strength: false after_filters: all: 1265 medium_plus: 412 high: null rows: - job_title: vp of sales seniority: vp company: acme medical supply industry: medical equipment manufacturing employees: 140 city: minneapolis state: mn keyword_matched: selling to group purchasing organizations intent_strength: high intent_score: 81 last_active: '2026-10-12' has_business_email: true has_phone: true has_linkedin: true '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: Sample: type: object properties: lane: type: string status: type: string enum: - ready - ready_check_in_progress - checking - none description: >- `ready`: rows from the latest checks. `ready_check_in_progress`: rows shown, a newer check is running. `checking`: a check is running and there are no rows yet. `none`: no rows (no check yet, or nobody matched). checked_at: type: - string - 'null' format: date-time data_window: anyOf: - $ref: '#/components/schemas/DataWindow' - type: 'null' min_strength: type: - string - 'null' enum: - all - medium - high - null description: >- The lane strength the check used, as a count band: `all` (lane `min_strength` low), `medium` (medium and high) or `high`. filters_used: type: string enum: - industries - company_list - industries_and_company_list description: >- Which filters the lane's headline count uses: its industries, your company list (company_list_mode `replace`), or both (`narrow`). sample_strength: type: - string - 'null' enum: - all - medium_plus - high - null description: Strength of the rows shown. below_lane_strength: type: boolean description: >- True when nobody passes at the lane's strength yet, so the rows are at any strength. note: type: string description: Present only when `below_lane_strength` is true. after_filters: anyOf: - $ref: '#/components/schemas/CheckCounts' - type: 'null' rows: type: array items: $ref: '#/components/schemas/SampleRow' maxItems: 25 description: Up to 25 rows. required: - lane - status - checked_at - data_window - min_strength - filters_used - sample_strength - below_lane_strength - after_filters - rows 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' 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 SampleRow: type: object properties: job_title: type: - string - 'null' seniority: type: - string - 'null' company: type: - string - 'null' industry: type: - string - 'null' employees: type: - integer - 'null' city: type: - string - 'null' state: type: - string - 'null' keyword_matched: type: - string - 'null' intent_strength: type: - string - 'null' enum: - low - medium - high - null intent_score: type: - number - 'null' last_active: type: - string - 'null' has_business_email: type: boolean has_phone: type: boolean has_linkedin: type: boolean required: - job_title - seniority - company - industry - employees - city - state - keyword_matched - intent_strength - intent_score - last_active - has_business_email - has_phone - has_linkedin description: >- An example match. No names or contact details. Values are as stored, so text is often lowercase. 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.