> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Request Export

> Requires active Pro and an owner-scoped REST bearer key. Required scopes: exports:write, contacts:read. Creates an owner-scoped CSV job pinned to an authorized selection and published release. Save the payload and Idempotency-Key before submission. REST uses the user's explicit selection authorization and has no MCP browser-approval step; hosted MCP additionally requires owner approval through confirmation_url and an identical retry with the same key. Renewal selections additionally require insurance:read and insurance availability; edition selections require current historical access. The sample selection is dashboard-only.



## OpenAPI

````yaml /openapi.json post /exports
openapi: 3.1.1
info:
  title: TruckerFetch Pro API
  version: 1.0.0
  description: >-
    Owner-scoped carrier, authority and observed-insurance research. All data
    operations require active Pro. Additional scopes, historical grants, source
    availability and current suppressions apply. Source observation, effective
    dates, edition dates and renewal estimates represent distinct facts.
servers:
  - url: https://truckerfetch.com/api/v1
security: []
paths:
  /exports:
    post:
      summary: Request Export
      description: >-
        Requires active Pro and an owner-scoped REST bearer key. Required
        scopes: exports:write, contacts:read. Creates an owner-scoped CSV job
        pinned to an authorized selection and published release. Save the
        payload and Idempotency-Key before submission. REST uses the user's
        explicit selection authorization and has no MCP browser-approval step;
        hosted MCP additionally requires owner approval through confirmation_url
        and an identical retry with the same key. Renewal selections
        additionally require insurance:read and insurance availability; edition
        selections require current historical access. The sample selection is
        dashboard-only.
      operationId: requestExport
      parameters:
        - in: header
          name: Idempotency-Key
          required: true
          description: >-
            Persist this key with the exact request payload and reuse both after
            a timeout or confirmation; a changed payload conflicts.
          schema:
            type: string
            minLength: 8
            maxLength: 128
            pattern: ^[-._:a-zA-Z0-9]{8,128}$
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              properties:
                scope:
                  type: string
                  enum:
                    - edition
                    - catalog
                    - list
                    - renewals
                date_basis:
                  type: string
                  enum:
                    - filing_anniversary
                    - estimated_policy_renewal
                    - verified_expiration
                    - filed_cancellation
                    - unknown
                window_days:
                  anyOf:
                    - type: number
                      const: 30
                    - type: number
                      const: 45
                    - type: number
                      const: 60
                edition_id:
                  type: string
                  format: uuid
                  pattern: >-
                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                list_id:
                  type: string
                  format: uuid
                  pattern: >-
                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                filters:
                  type: object
                  properties:
                    q:
                      type: string
                      maxLength: 160
                    states:
                      maxItems: 51
                      type: array
                      items:
                        type: string
                        pattern: ^[A-Z]{2}$
                    classifications:
                      maxItems: 64
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 100
                    entity_types:
                      maxItems: 64
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 100
                    cargo:
                      maxItems: 64
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 100
                    filing_types:
                      maxItems: 64
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 100
                    insurer:
                      type: string
                      minLength: 1
                      maxLength: 160
                    census_status:
                      maxItems: 64
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 100
                    operations:
                      maxItems: 64
                      type: array
                      items:
                        type: string
                        minLength: 1
                        maxLength: 100
                    fleet:
                      type: object
                      properties:
                        min:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                        max:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                      additionalProperties: false
                    trucks:
                      type: object
                      properties:
                        min:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                        max:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                      additionalProperties: false
                    drivers:
                      type: object
                      properties:
                        min:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                        max:
                          type: integer
                          minimum: 0
                          maximum: 9007199254740991
                      additionalProperties: false
                  additionalProperties: false
                usdots:
                  maxItems: 25000
                  type: array
                  items:
                    type: string
                    pattern: ^[0-9]{1,16}$
              required:
                - scope
              additionalProperties: false
              description: >-
                Use edition_id only for edition scope and list_id only for list
                scope. Renewal scope requires date_basis and window_days; other
                scopes must omit them. Optional usdots limits the authorized
                selection.
              allOf:
                - if:
                    properties:
                      scope:
                        const: edition
                    required:
                      - scope
                  then:
                    required:
                      - edition_id
                  else:
                    not:
                      required:
                        - edition_id
                - if:
                    properties:
                      scope:
                        const: list
                    required:
                      - scope
                  then:
                    required:
                      - list_id
                  else:
                    not:
                      required:
                        - list_id
                - if:
                    properties:
                      scope:
                        const: renewals
                    required:
                      - scope
                  then:
                    required:
                      - date_basis
                      - window_days
                  else:
                    not:
                      anyOf:
                        - required:
                            - date_basis
                        - required:
                            - window_days
      responses:
        '202':
          description: Authorized operation result
          headers:
            X-Request-Id:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data: {}
                  meta:
                    type: object
                  next_cursor:
                    type: string
        '400':
          description: Invalid request
        '401':
          description: Credential required
        '402':
          description: Active Pro required
        '403':
          description: Insufficient scope or allowance
        '404':
          description: Unknown or inaccessible resource
        '409':
          description: >-
            Idempotency conflict, changed projection or owner confirmation
            required
        '410':
          description: >-
            Expired cursor, artifact or dated edition outside the rolling 90-day
            Lead History window (archive_expired); the latest published edition
            remains available
        '429':
          description: Request limit exceeded
          headers:
            Retry-After:
              schema:
                type: string
        '503':
          description: Service or binding unavailable
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Owner-scoped Pro API key

````

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