---
title: "Query leads"
method: GET
path: "/v1/leads/query"
tags: ["leads"]
---

# Query leads

`GET /v1/leads/query`

## Request

- Base URL: `https://api.zevari.ai`
- URL: `https://api.zevari.ai/v1/leads/query`
- Auth: HTTP bearer

Transport: call this endpoint with HTTP GET and query parameters. Query the global leads database with filters for headline, source, qualification status, email, replies and intent. If you will draft or stage outbound copy from returned leads, call library_context_get next and apply the returned Outreach template plus Brand context before writing.

## Query parameters

- `keyword` string: Deprecated: matched a field that is no longer stored; a non-empty value returns no rows. Use search or headline_filter.
- `headline_filter` string: Case-insensitive search on headline
- `source` 'comments' | 'dms' | 'intent' | 'search': Filter by where the lead came from: a LinkedIn comment, a LinkedIn message (or any reply), a buying signal / own-post engagement (or a marked intent), or a LinkedIn / saved search
- `has_email` boolean: Filter leads that have email
- `has_intent` boolean: Filter leads with intent signals
- `has_ever_replied` boolean: Filter leads by whether they have ever replied
- `has_active_campaign_target` boolean: Filter leads by active pending or in-progress campaign target membership
- `quiet_since_days` integer: Return open leads that replied before this many days ago, with no newer outbound reply
- `qualification` 'qualified' | 'unqualified': Filter by qualification
- `search` string: Free text search across name and headline
- `limit` number: Max results
- `offset` number: Pagination offset

## Response `200`

Successful Zevari API response.

- ZevariResponseEnvelope
  - `ok` boolean, required: False when the underlying tool reports an error or a partial failure.
  - `method` string, required: Public API method name.
  - `data` unknown, required
  - `request_id` string, required: Request correlation ID. Also returned in X-Zevari-Request-Id.

## Other responses

- `400`: Invalid arguments or method execution error.
- `401`: Missing, invalid, expired, revoked, or unauthorized API key.
- `404`: Unknown or non-public Zevari API method.
- `429`: API key rate limit exceeded.
- `500`: Unhandled server error.

---

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