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

# Get filters with criteria



## OpenAPI

````yaml /api-reference/openapi.json post /v2/filters
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/filters:
    post:
      tags:
        - filters
      summary: Get filters with criteria
      operationId: aed3fc5db224ead388c59766f04f0519
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostFiltersCriteriaBody'
      responses:
        '200':
          description: Filter metadata from the product API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductApiPassthroughObject'
      security:
        - bearerAuth: []
        - auth:
            - read
components:
  schemas:
    PostFiltersCriteriaBody:
      title: POST filters criteria
      description: >-
        Optional criteria. Full field list is under Schema (Example Value may be
        auto-generated).
      properties:
        rtics:
          description: Selected RTIC codes.
          type: array
          items:
            type: string
        cics:
          description: User CIC codes.
          type: array
          items:
            type: string
        CompanyNumbers:
          description: >-
            Inline company numbers (typically up to ~50k). Use a low
            `returnCount` for huge portfolios so the JSON response stays small —
            with `?insights=true`, `insights` still aggregates the full matched
            set.
          type: array
          items:
            type: string
        CompanyNumberSetId:
          description: >-
            Use instead of `CompanyNumbers` when the list is too large to send
            inline (roughly >50k) — upload via POST /v2/company-number-sets
            first.
          type: string
        AllowLargeAnalysis:
          description: Required when using a large uploaded company number set.
          type: boolean
      type: object
    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

````