---
title: "Count leads by status"
method: GET
path: "/v1/ads/leads/counts"
tags: ["Lead Gen"]
---

# Count leads by status

`GET /v1/ads/leads/counts`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/ads/leads/counts`
- Auth: HTTP bearer

Counts your team's stored Meta leads per status, for a status filter or a "new leads" badge.

Every status is present, with 0 when no lead has it. Requires the Ads add-on.

## Query parameters

- `accountId` string
- `campaignId` string

## Response `200`

Lead counts.

- object
  - `status` string
  - `counts` object
    - `new` integer
    - `contacted` integer
    - `unreachable` integer
    - `qualified` integer
    - `converted` integer
    - `disqualified` integer
  - `total` integer

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: Ads add-on required.

## Changes

- **2026-10-27** `74d22f0c2df1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/ads/leads/counts/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/c319eb5d95b6?raw)