> ## 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 exports

> 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}`.

**Free.** This doesn't use any contacts from your plan.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/exports
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/exports:
    get:
      tags:
        - Exports
      summary: List exports
      description: >-
        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}`.


        **Free.** This doesn't use any contacts from your plan.
      operationId: listExports
      responses:
        '200':
          description: Exports, newest first.
          content:
            application/json:
              schema:
                type: object
                properties:
                  exports:
                    type: array
                    items:
                      $ref: '#/components/schemas/Export'
                required:
                  - exports
              example:
                exports:
                  - id: 0199e3a1-2f4b-7c10-8e2d-1a2b3c4d5e6f
                    status: completed
                    lanes:
                      - L1
                      - L2
                    requested: 250
                    will_export: 250
                    exported: 250
                    min_strength: null
                    billing_period: '2026-10-01'
                    via: api
                    created_at: '2026-10-14T09:30:02.114502+00:00'
                    finished_at: '2026-10-14T09:41:55.903117+00:00'
                    error: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    Export:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Export id.
        status:
          type: string
          enum:
            - queued
            - running
            - completed
            - partial
            - failed
          description: >-
            `queued` and `running` are in progress. `completed`: everything
            reserved was exported. `partial`: some people were exported, fewer
            than `will_export`. `failed`: nobody was exported. Contacts that
            weren't used go back to your allowance.
        lanes:
          type: array
          items:
            type: string
          description: Lane codes, in the order they're filled.
        requested:
          type: integer
          description: >-
            The number reserved when the export started (the quote's
            `will_export`), not the `max` you sent.
        will_export:
          type: integer
          description: Contacts reserved for this export.
        exported:
          type: integer
          description: People exported so far. Only these count against your plan.
        min_strength:
          type:
            - string
            - 'null'
          enum:
            - low
            - medium
            - high
            - null
          description: >-
            Strength override sent with the export, or null for each lane's own
            `min_strength`.
        billing_period:
          type: string
          format: date
          description: Start date of the billing period the export counts against.
        via:
          type: string
          enum:
            - dashboard
            - api
            - cli
            - mcp
          description: Where the export was started.
        created_at:
          type: string
          format: date-time
        finished_at:
          type:
            - string
            - 'null'
          format: date-time
        error:
          type:
            - string
            - 'null'
          description: >-
            Why a `partial` or `failed` export stopped short, e.g. `No new
            people were available in these lanes.` or `Fewer new people were
            available than estimated.` Always null for other statuses.
      required:
        - id
        - status
        - lanes
        - requested
        - will_export
        - exported
        - min_strength
        - billing_period
        - via
        - created_at
        - finished_at
        - error
      example:
        id: 0199e3a1-2f4b-7c10-8e2d-1a2b3c4d5e6f
        status: completed
        lanes:
          - L1
          - L2
        requested: 250
        will_export: 250
        exported: 250
        min_strength: null
        billing_period: '2026-10-01'
        via: api
        created_at: '2026-10-14T09:30:02.114502+00:00'
        finished_at: '2026-10-14T09:41:55.903117+00:00'
        error: null
    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_…'
    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.