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

# Start Export

> Queue a bulk CSV export of every person matching the filters



## OpenAPI

````yaml POST /v1/exports
openapi: 3.0.3
info:
  title: Maverick Intelligence API
  description: >
    Programmatic access to your Maverick Intelligence data — identified website
    visitors,

    companies, events, and analytics.


    ## Authentication

    All endpoints (except `/v1/health`) require an API key passed in the
    `X-API-Key` header.


    ```bash

    curl -H "X-API-Key: mk_live_your_key_here"
    https://api-v1.maverickintelligence.co/v1/people

    ```


    ## Rate Limiting

    - **1,000 requests per hour** per customer (shared across all API keys)

    - Every response includes `X-RateLimit-Limit` and `X-RateLimit-Remaining`
    headers

    - When exceeded, you'll receive a `429` response with a `Retry-After` header


    ## Pagination

    List endpoints use cursor-based pagination. Pass the `nextCursor` from the
    response

    as the `cursor` query parameter to fetch the next page.


    ## Sorting

    Results are always sorted by most recently seen first (`lastSeen`
    descending).

    Custom sorting is not yet supported — passing a `sort` or `order` query

    parameter returns `400 bad_request`. Custom sorting options will be
    available

    in a future version.
  version: 1.0.0
  contact:
    name: Maverick Intelligence Support
    email: nick@maverickintelligence.co
    url: https://maverickintelligence.co
servers:
  - url: https://api-v1.maverickintelligence.co
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: System
    description: API health and status
  - name: People
    description: Identified website visitors
  - name: Events
    description: Behavioral events (page views, clicks, scrolls)
  - name: Companies
    description: Companies identified from visitors
  - name: Statistics
    description: Aggregate analytics
  - name: Exports
    description: Bulk CSV export of the full dataset
paths:
  /v1/exports:
    post:
      tags:
        - Exports
      summary: Start a bulk export
      description: >
        Build a CSV of every person matching the filters and return a link to it
        — the whole dataset, not one page. This is the headless equivalent of
        the Export button in the dashboard, and it produces the identical file.


        The work is asynchronous: this returns a `jobId` immediately, then poll
        `GET /v1/exports/{jobId}` until `status` is `complete` and a
        `downloadUrl` appears. A large account takes a minute or two.


        API keys scoped to specific client domains cannot call this endpoint —
        exports are account-wide. Use an unscoped key.
      operationId: createExport
      requestBody:
        required: false
        description: >
          Filters. Omit the body entirely to export everything. Array values may
          be sent as JSON arrays or comma-separated strings.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExportRequest'
      responses:
        '202':
          description: Export accepted and queued
          content:
            application/json:
              schema:
                type: object
                properties:
                  jobId:
                    type: string
                  status:
                    type: string
                    enum:
                      - processing
                  statusUrl:
                    type: string
                  pollAfterSeconds:
                    type: integer
        '400':
          description: Unsupported filter or malformed body
        '403':
          description: The API key is scoped to client domains
        '429':
          description: >
            Rate limit exceeded, or three exports are already running for this
            account.
components:
  schemas:
    ExportRequest:
      type: object
      additionalProperties: false
      properties:
        timeframe:
          type: string
          enum:
            - 24h
            - 7d
            - 30d
            - 90d
            - all
          description: 'How far back to include. Default: everything.'
        dateField:
          type: string
          description: Which date `timeframe` applies to. Default `lastSeen`.
        isHotLead:
          type: boolean
          description: Only visitors currently qualifying as hot leads.
        industries:
          type: array
          items:
            type: string
        regions:
          type: array
          items:
            type: string
        seniority:
          type: array
          items:
            type: string
        jobFunctions:
          type: array
          items:
            type: string
        domains:
          type: array
          items:
            type: string
          description: Restrict to visitors on these tracked site domains.
        pages:
          type: array
          items:
            type: string
          description: Restrict to visitors who saw these page paths.
        campaigns:
          type: array
          items:
            type: string
        trafficTypes:
          type: array
          items:
            type: string
        adPlatforms:
          type: array
          items:
            type: string
        visitCountMin:
          type: integer
          minimum: 1
        hasBusinessEmail:
          type: boolean
        hasLinkedIn:
          type: boolean
        hasPhone:
          type: boolean
        multiClientOnly:
          type: boolean
        crmStatus:
          type: string
          enum:
            - in_crm
            - not_in_crm
            - customers
        search:
          type: string
          description: Free-text match across name, company and email.
        sortBy:
          type: string
        sortOrder:
          type: string
          enum:
            - asc
            - desc
        filename:
          type: string
          description: 'Name for the downloaded file. Default: maverick_people_<date>.csv'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'API key in format: mk_live_{40 hex chars}'

````