---
title: "Count saved leads matching filters (FREE, exact)"
method: POST
path: "/api/v1/count"
---

# Count saved leads matching filters (FREE, exact)

`POST /api/v1/count`

## Request

- Base URL: `https://lyreleads.com`
- URL: `https://lyreleads.com/api/v1/count`
- Auth: HTTP bearer

Returns an exact count of the caller's saved leads for any filter combination, plus a breakdown of how many are enriched, have an email, have a contact email, or have been relevance-checked. Costs nothing at any size. Call this before every action that spends. Presence filters are three-state aware: false means "enriched and confirmed absent", never "blank".

## Request body

- object
  - `query` string: Substring match on the search keyword
  - `city` string
  - `country` string
  - `type` string: Google Maps business category substring
  - `search_id` string
  - `has_email` boolean
  - `has_website` boolean
  - `has_contact_email` boolean
  - `has_cms` boolean
  - `has_crm` boolean: false = enriched and no CRM detected. The classic "sell them a CRM" filter.
  - `phone_match` 'match' | 'mismatch' | 'absent' | 'unknown': Does the phone on the company website agree with the phone on its Google Business Profile? "absent" means no phone was found on the site at all.
  - `email_verification_status` 'verified' | 'published' | 'catch_all' | 'unknown' | 'invalid'
  - `enrichment_status` 'enriched' | 'pending' | 'unverifiable' | 'no_website' | 'failed'
  - `ai_crawler_access` 'open' | 'partial' | 'blocked' | 'unknown'
  - `min_rating` number
  - `max_rating` number
  - `min_reviews` integer
  - `max_reviews` integer
  - `relevance` 'yes' | 'no' | 'unclear': Did the enrichment relevance check judge this row to be the kind of business its own search query asked for? Free, runs on every enriched lead with a readable website. Absent means never judged, which is not the same as "no".
  - `enrolled` boolean: true = enrolled in enrichment, re-checked about monthly at no charge. false = not enrolled (usually an import); enrolling it with POST /api/v1/leads/enroll costs one lead per two businesses.

## Response `200`

Exact count, completeness breakdown (including enrolled / not_enrolled), and leads_charged: 0

---

[API](https://skmtc.dev/lyreleads/apis/lyre-leads-api.md) · [All operations](https://skmtc.dev/lyreleads/apis/lyre-leads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lyreleads/apis/lyre-leads-api/revisions/1c7c73cc355f?raw)