---
title: "Top Combinations"
method: GET
path: "/api/v1/leads/top-combinations"
tags: ["leads", "leads"]
---

# Top Combinations

`GET /api/v1/leads/top-combinations`

## Request

- Base URL: `https://app.goodleads.club` (the document declares no server; this is the origin it was published from)
- URL: `https://app.goodleads.club/api/v1/leads/top-combinations`
- Auth: none declared

Top industry-name × metro combinations for the Inventory "hottest
pockets" leaderboard (e.g. "roofing · Tampa", "dental · Denver").

The combination is the unit a territory seller buys — a specific trade in a
specific metro. Dedicated, cached aggregation kept off the `/leads/summary`
fast path. Each item carries a *compound* `filters` array
`[{industry_name eq}, {msa_name eq}]` that Browse AND's together (Rule 12),
so a row deep-links straight to its exact cohort.

## Query parameters

- `state` string, required: State code (e.g. FL, NY, CO, VA)
- `include_non_operating` boolean: Sellable-only counts by default; set true to include non-operating entities.
- `include_existing` boolean: Include existing businesses with a new filing: companies opening a location here, local owners who formed their company in another state, businesses back in business, established businesses under a new entity, moved, or with a new trade name. Default False — Just started only (a brand-new business), matching every file sold as new businesses. Naming a filing_kind in `filters` implies it.
- `include_registrations` boolean: Deprecated alias of include_existing (kept one release so saved links resolve).

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodleads/apis/formation-gtm-api.md) · [All operations](https://skmtc.dev/goodleads/apis/formation-gtm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodleads/apis/formation-gtm-api/revisions/2068d13a82cf?raw)