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

# Export list



## OpenAPI

````yaml /api-reference/openapi.json post /v2/companies/export
openapi: 3.0.0
info:
  title: The Data City API (v2)
  description: API v2. Use these endpoints for new integrations.
  version: 2.0.0
servers:
  - url: https://product-api.thedatacity.com/api
    description: Production
security: []
tags:
  - name: classification
    description: >-
      Classification and ML: classify companies, list summary, explain
      classifier, explain company score.
  - name: companies
    description: >-
      Companies: details, group structure, check, batch, export, filtered
      companies.
  - name: directors
    description: 'Directors: director details by person number.'
  - name: explore
    description: 'Explore lists: filter-based lists by list ID, domain, or email.'
  - name: filters
    description: 'Filters: get available filters and filtered company results.'
  - name: rtics
    description: RTIC details and metadata.
  - name: search
    description: 'Search: ahead full and full-text search.'
  - name: smart-lists
    description: 'User lists (ML): list details by list ID, domain, or email.'
paths:
  /v2/companies/export:
    post:
      tags:
        - companies
      summary: Export list
      operationId: d99cf38f4b43c990632b12c792a1db8e
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV2CompaniesExportBody'
      responses:
        '200':
          description: >-
            Export payload or file metadata from the product API (format depends
            on DownloadFormat).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductApiPassthroughObject'
      security:
        - bearerAuth: []
        - auth:
            - companies:downloadList
components:
  schemas:
    PostV2CompaniesExportBody:
      title: POST /v2/companies/export
      description: Full shape is under Schema; example is minimal.
      properties:
        orderBy:
          description: JSON body for POST /v2/companies/export.
          type: string
        order:
          type: string
        downloadDetail:
          type: string
        downloadFormat:
          type: string
        companyNumbers:
          type: array
          items:
            type: string
        containsKeyword:
          type: string
        doesNotContainsKeyword:
          type: string
        returnCount:
          type: integer
      type: object
      example:
        companyNumbers:
          - '10958787'
        returnCount: 20
    ProductApiPassthroughObject:
      description: >-
        JSON object returned from the upstream product API with no extra shaping
        by this gateway. Exact properties depend on the operation. Fields may be
        omitted when the token lacks optional scopes (see `config/api.php`
        scope_field_map).
      type: object
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      bearerFormat: JWT
      scheme: bearer

````