---
title: "List Firmographic Options"
method: GET
path: "/api/v1/account/firmographic-options"
tags: ["Firmographic Options"]
---

# List Firmographic Options

`GET /api/v1/account/firmographic-options`

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

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- FirmographicOptionsResponse — Acceptable firmographic filter values for the lookalike search endpoints (`GET /search-lookalikes` and `POST /search-lookalikes-bulk`).
  - `min_employees` FirmographicEmployeeBound, required — Accepted range for an employee-count filter on lookalike search.
    - `minimum` integer, required — Smallest accepted value (inclusive).
    - `maximum` integer, nullable — Largest accepted value (inclusive), or null if unbounded.
  - `max_employees` FirmographicEmployeeBound, required — Accepted range for an employee-count filter on lookalike search.
    - `minimum` integer, required — Smallest accepted value (inclusive).
    - `maximum` integer, nullable — Largest accepted value (inclusive), or null if unbounded.
  - `funding_stages` string[], required — Exact funding-stage labels accepted by `funding_stages`. Input is matched case-insensitively and canonicalized to these values.
  - `locations` FirmographicLocationOption[], required — Supported HQ-country filters. Pass the `code` in the `locations` parameter.
    - `code` string, required — ISO 3166-1 alpha-3 code to pass in the `locations` parameter.
    - `name` string, required — Canonical country name.

---

[API](https://skmtc.net/openfunnel/apis/openfunnel-agent-primitives.md) · [All operations](https://skmtc.net/openfunnel/apis/openfunnel-agent-primitives/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openfunnel/openfunnel-agent-primitives/revisions/68cc95acb1f2/schema)