---
title: "Find Leads"
method: POST
path: "/v1/leads/find"
tags: ["leads"]
---

# Find Leads

`POST /v1/leads/find`

The buy-box leads feed (cache-only). `count_only=true` returns just the live match count +
per-verdict split (cheap GROUP BY) for the builder; otherwise it also returns the ranked rows.

## Query parameters

- `limit` integer

## Headers

- `authorization` string, nullable
- `X-Tenant` string, nullable

## Request body

- object

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mireye/apis/mireye-scout-api.md) · [All operations](https://skmtc.net/mireye/apis/mireye-scout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mireye/mireye-scout-api/versions/7c501afae006/schema)