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

# Get available audience filter definitions

> Returns the curated Orbit audience filter catalog. Values and counts are read from the cached ClickHouse catalog when available; otherwise static filter definitions are returned.



## OpenAPI

````yaml https://api.aws53.cloud/openapi-intent.json get /v1/intent/audiences/filters
openapi: 3.1.0
info:
  title: Orbit API
  version: 1.0.0
  description: >-
    Orbit Audience Intent API: topic discovery, site analysis, curated ICP
    filters, saved audiences, materialization runs, stats, and CSV export.
    Discovery endpoints are public; audience management accepts either Bearer
    JWT or X-API-Key auth.
servers:
  - url: https://api.aws53.cloud
    description: Production
security: []
tags:
  - name: Topic Discovery
    description: Browse, search, and analyze available intent topics
  - name: Site Analysis
    description: Analyze a website URL to find matching intent topics
  - name: Site Topics
    description: Recent organization site-topic analyses
  - name: Audience Builder
    description: >-
      Curated filters, preview, saved audiences, runs, stats, CSV export, and
      saved topic lists
paths:
  /v1/intent/audiences/filters:
    get:
      tags:
        - Audience Builder
      summary: Get available audience filter definitions
      description: >-
        Returns the curated Orbit audience filter catalog. Values and counts are
        read from the cached ClickHouse catalog when available; otherwise static
        filter definitions are returned.
      responses:
        '200':
          description: Audience filter catalog
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceFilterCatalogResponse'
components:
  schemas:
    AudienceFilterCatalogResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            version:
              type: object
              properties:
                status:
                  type: string
                  enum:
                    - catalog
                    - static_fallback
                sourceTable:
                  type: string
                catalogTable:
                  type: string
                catalogVersion:
                  type:
                    - string
                    - 'null'
                buildId:
                  type:
                    - string
                    - 'null'
                buildDate:
                  type:
                    - string
                    - 'null'
                generatedAt:
                  type:
                    - string
                    - 'null'
              required:
                - status
                - sourceTable
                - catalogTable
                - catalogVersion
                - buildId
                - buildDate
                - generatedAt
            summary:
              type: object
              properties:
                groupCount:
                  type: number
                filterCount:
                  type: number
                valueCount:
                  type: number
                recommendedFilterCount:
                  type: number
                standardFilterCount:
                  type: number
                advancedFilterCount:
                  type: number
                supportsAdvancedLogic:
                  type: boolean
                defaultFieldLogic:
                  type: string
                  enum:
                    - and
              required:
                - groupCount
                - filterCount
                - valueCount
                - recommendedFilterCount
                - standardFilterCount
                - advancedFilterCount
                - supportsAdvancedLogic
                - defaultFieldLogic
            logic:
              type: object
              properties:
                summary:
                  type: string
                uiHints:
                  type: object
                  properties:
                    useFields:
                      type: array
                      items:
                        type: string
                    technicalFields:
                      type: array
                      items:
                        type: string
                    valueHint:
                      type: string
                  required:
                    - useFields
                    - technicalFields
                    - valueHint
                simpleFilters:
                  type: object
                  properties:
                    shape:
                      type: string
                    topLevelLogic:
                      type: string
                    multiSelectValueLogic:
                      type: string
                    textTermLogic:
                      type: string
                  required:
                    - shape
                    - topLevelLogic
                    - multiSelectValueLogic
                    - textTermLogic
                advancedFilters:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                    keys:
                      type: array
                      items:
                        type: string
                        enum:
                          - and
                          - or
                    conditionShape:
                      type: string
                    rules:
                      type: array
                      items:
                        type: string
                  required:
                    - enabled
                    - keys
                    - conditionShape
                    - rules
                examples:
                  type: object
                  properties:
                    simple:
                      type: object
                      additionalProperties: {}
                    or:
                      type: object
                      additionalProperties: {}
                    nested:
                      type: object
                      additionalProperties: {}
                  required:
                    - simple
                    - or
                    - nested
              required:
                - summary
                - uiHints
                - simpleFilters
                - advancedFilters
                - examples
            groups:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                  label:
                    type: string
                  description:
                    type: string
                  filters:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                        label:
                          type: string
                        type:
                          type: string
                          enum:
                            - multi_select
                            - boolean
                            - text_terms
                            - number_range
                        valueType:
                          type: string
                          enum:
                            - enum
                            - boolean
                            - string
                            - number
                        operators:
                          type: array
                          items:
                            type: string
                        sourceColumn:
                          type: string
                        source:
                          type: string
                          enum:
                            - serving
                            - filter_surface
                            - both
                        requiresSidecar:
                          type: boolean
                        isSearchOnly:
                          type: boolean
                        maxValues:
                          type: number
                        maxTerms:
                          type: number
                        min:
                          type: number
                        max:
                          type: number
                        ui:
                          type: object
                          properties:
                            label:
                              type: string
                            description:
                              type: string
                            control:
                              type: string
                              enum:
                                - multi_select
                                - toggle
                                - text_chips
                                - number_range
                            section:
                              type: string
                              enum:
                                - recommended
                                - standard
                                - advanced
                            order:
                              type: number
                            recommended:
                              type: boolean
                            advanced:
                              type: boolean
                            placeholder:
                              type: string
                            helperText:
                              type: string
                            examples:
                              type: array
                              items:
                                type: string
                            valueLabelStyle:
                              type: string
                              enum:
                                - title
                                - code
                                - range
                                - grade
                            allowCustomValues:
                              type: boolean
                          required:
                            - label
                            - description
                            - control
                            - section
                            - order
                            - recommended
                            - advanced
                        values:
                          type: array
                          items:
                            type: object
                            properties:
                              value:
                                type: string
                              label:
                                type: string
                              count:
                                type: number
                            required:
                              - value
                              - label
                              - count
                      required:
                        - key
                        - label
                        - type
                        - valueType
                        - operators
                        - sourceColumn
                        - source
                        - requiresSidecar
                        - isSearchOnly
                        - ui
                required:
                  - key
                  - label
                  - description
                  - filters
          required:
            - version
            - summary
            - logic
            - groups
      required:
        - data

````