---
title: "Counts By Url"
method: GET
path: "/api/v1/counts"
tags: ["lists", "lists"]
---

# Counts By Url

`GET /api/v1/counts`

## 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/counts`
- Auth: API key in header `X-API-Key`

The summary as one GET — for agents and tools that can fetch a URL but cannot POST.

Same numbers, same filter contract, same `group_by` as `POST /leads/summary`
(this is a thin adapter over it); no key needed for counts.

## Query parameters

- `states` string: Comma-separated state codes; empty = every live state.
- `filters` string, nullable: JSON-encoded filter array — the same contract as POST /leads/summary.
- `group_by` string: Comma-separated fields (max 2) to cross-tab by, e.g. property_classification,naics_2_digit.
- `include_existing` boolean

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