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

# Download CSV Export

> Streams a CSV export of prospects, published comments or Dashboard statistics (`text/csv`). A file holds at most 10000 rows; a larger export is refused with a message to narrow the filter (a campaign, a list or a shorter period), never cut off. Up to 2 exports of one caller run at a time, and the same export started again within 60 seconds is refused with 429. Access follows the caller's own rights, exactly as the corresponding lists in the app; an inaccessible campaign or list is refused with 403. The file is UTF-8 with a BOM, with snake_case column names, ISO 8601 dates and full URLs.



## OpenAPI

````yaml https://api.goextrovert.com/client/v2/docs-json get /client/v2/csv-export
openapi: 3.1.0
info:
  title: Extrovert Client API
  description: >-
    Public API for Extrovert platform integration. Use your API key for
    authentication.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.goextrovert.com/
    description: API Server
security: []
tags: []
paths:
  /client/v2/csv-export:
    get:
      tags:
        - CSV Export
      summary: Download CSV Export
      description: >-
        Streams a CSV export of prospects, published comments or Dashboard
        statistics (`text/csv`). A file holds at most 10000 rows; a larger
        export is refused with a message to narrow the filter (a campaign, a
        list or a shorter period), never cut off. Up to 2 exports of one caller
        run at a time, and the same export started again within 60 seconds is
        refused with 429. Access follows the caller's own rights, exactly as the
        corresponding lists in the app; an inaccessible campaign or list is
        refused with 403. The file is UTF-8 with a BOM, with snake_case column
        names, ISO 8601 dates and full URLs.
      operationId: CsvExportClientApiController_download
      parameters:
        - description: >-
            What the file contains. `prospects`: prospects with their connection
            and engagement numbers; filter by `campaignId` or `listId`.
            `comments`: comments published on LinkedIn, oldest first; filter by
            `campaignId` and the period, no period means all time. `statistics`:
            the Dashboard numbers, one row per day; the period is required and
            keeps the Dashboard limit of 31 days.
          required: true
          x-nestjs_zod-parent-metadata:
            dependentRequired:
              startDate:
                - endDate
              endDate:
                - startDate
          name: type
          in: query
          schema:
            enum:
              - prospects
              - comments
              - statistics
            type: string
        - description: >-
            Optional campaign ID in the caller's scope; omit for every
            accessible campaign.
          required: false
          x-nestjs_zod-parent-metadata:
            dependentRequired:
              startDate:
                - endDate
              endDate:
                - startDate
          name: campaignId
          in: query
          schema:
            type: string
            format: uuid
        - description: Optional prospect list ID; `prospects` only.
          required: false
          x-nestjs_zod-parent-metadata:
            dependentRequired:
              startDate:
                - endDate
              endDate:
                - startDate
          name: listId
          in: query
          schema:
            type: string
            format: uuid
        - description: >-
            First calendar day of the period, included, `YYYY-MM-DD`. Given
            together with `endDate`.
          examples:
            example1:
              value: '2026-10-01'
          required: false
          x-nestjs_zod-parent-metadata:
            dependentRequired:
              startDate:
                - endDate
              endDate:
                - startDate
          name: startDate
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - description: >-
            Last calendar day of the period, included, `YYYY-MM-DD`. Given
            together with `startDate`.
          examples:
            example1:
              value: '2026-10-31'
          required: false
          x-nestjs_zod-parent-metadata:
            dependentRequired:
              startDate:
                - endDate
              endDate:
                - startDate
          name: endDate
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - description: >-
            IANA timezone the calendar days are taken in. Required for
            `statistics` (use the user's profile timezone to match the
            Dashboard); `comments` uses UTC without it. In the export link it
            may be omitted: the Extrovert app then uses the visitor's profile
            timezone.
          examples:
            example1:
              value: Europe/Berlin
          required: false
          x-nestjs_zod-parent-metadata:
            dependentRequired:
              startDate:
                - endDate
              endDate:
                - startDate
          name: timezone
          in: query
          schema:
            type: string
            minLength: 1
      responses:
        '200':
          description: The CSV file.
          content:
            text/csv:
              schema:
                type: string
        '401':
          description: Invalid or missing API key.
          content:
            text/csv:
              schema:
                $ref: '#/components/schemas/ClientApiErrorResponseDto'
      security:
        - api-key: []
components:
  schemas:
    ClientApiErrorResponseDto:
      type: object
      properties:
        status:
          type: string
          description: Response status
          example: error
          enum:
            - error
        data:
          type: 'null'
          description: Response data
          example: null
        message:
          type: string
          description: Error message
          example: An error occurred while processing the request
      required:
        - status
        - data
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key for authentication

````

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