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

# List Firmographic Options

> Returns the firmographic filter values accepted by the lookalike search endpoints
One-shot discovery call - static, safe to cache.



## OpenAPI

````yaml agent-primitives/openapi.json GET /api/v1/account/firmographic-options
openapi: 3.1.0
info:
  title: OpenFunnel Agent Primitives
  version: 1.0.0
servers:
  - url: https://api.openfunnel.dev
security: []
paths:
  /api/v1/account/firmographic-options:
    get:
      tags:
        - Firmographic Options
      summary: List Firmographic Options
      description: >-
        Returns the firmographic filter values accepted by the lookalike search
        endpoints

        One-shot discovery call - static, safe to cache.
      operationId: account_firmographic_options
      parameters:
        - name: X-API-Key
          in: header
          required: true
          schema:
            type: string
            title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FirmographicOptionsResponse'
              example:
                min_employees:
                  minimum: 0
                  maximum: null
                max_employees:
                  minimum: 0
                  maximum: null
                funding_stages:
                  - Pre-Seed
                  - Seed
                  - Series A
                  - Series B
                  - Series C
                  - Series D
                  - Series E
                  - Series F
                  - Series G
                  - Series H
                  - Acquired
                  - Private
                  - Public
                locations:
                  - code: USA
                    name: United States
                  - code: CAN
                    name: Canada
      x-codeSamples:
        - lang: bash
          label: List firmographic options
          source: >-
            curl -sS
            "https://api.openfunnel.dev/api/v1/account/firmographic-options" \
              -H "X-API-Key: YOUR_API_KEY"
components:
  schemas:
    FirmographicOptionsResponse:
      type: object
      title: FirmographicOptionsResponse
      description: >-
        Acceptable firmographic filter values for the lookalike search endpoints
        (`GET /search-lookalikes` and `POST /search-lookalikes-bulk`).
      required:
        - min_employees
        - max_employees
        - funding_stages
        - locations
      properties:
        min_employees:
          $ref: '#/components/schemas/FirmographicEmployeeBound'
          description: Bounds for the `min_employees` filter.
        max_employees:
          $ref: '#/components/schemas/FirmographicEmployeeBound'
          description: Bounds for the `max_employees` filter.
        funding_stages:
          type: array
          items:
            type: string
          title: Funding Stages
          description: >-
            Exact funding-stage labels accepted by `funding_stages`. Input is
            matched case-insensitively and canonicalized to these values.
        locations:
          type: array
          items:
            $ref: '#/components/schemas/FirmographicLocationOption'
          title: Locations
          description: >-
            Supported HQ-country filters. Pass the `code` in the `locations`
            parameter.
    FirmographicEmployeeBound:
      type: object
      title: FirmographicEmployeeBound
      description: Accepted range for an employee-count filter on lookalike search.
      required:
        - minimum
      properties:
        minimum:
          type: integer
          title: Minimum
          description: Smallest accepted value (inclusive).
        maximum:
          anyOf:
            - type: integer
            - type: 'null'
          title: Maximum
          description: Largest accepted value (inclusive), or null if unbounded.
    FirmographicLocationOption:
      type: object
      title: FirmographicLocationOption
      description: A supported HQ-country choice for the lookalike `locations` filter.
      required:
        - code
        - name
      properties:
        code:
          type: string
          title: Code
          description: ISO 3166-1 alpha-3 code to pass in the `locations` parameter.
        name:
          type: string
          title: Name
          description: Canonical country name.

````