---
title: "Search Leads"
method: GET
path: "/api/v3/crm/{integration_id}/leads/search"
tags: ["CRM Leads"]
---

# Search Leads

`GET /api/v3/crm/{integration_id}/leads/search`

Search for leads using various criteria.

**Query parameters**:
- `query`: Text search across name and company
- `lastname`: Filter by last name
- `company`: Filter by company name
- `email`: Filter by email
- `status`: Filter by lead status
- `industry`: Filter by industry

**Note**: This endpoint is only supported for Salesforce integrations.

## Path parameters

- `integration_id` string, uuid, required — The CRM integration ID

## Query parameters

- `query` string, nullable — Text search
- `lastname` string, nullable — Last name
- `company` string, nullable — Company name
- `email` string, nullable — Email address
- `status` string, nullable — Lead status
- `industry` string, nullable — Industry
- `limit` integer — Number of results

## Response `200`

Successful Response

- LeadListAPIResponse — API response for listing leads.
  - `results` LeadResponse[], required
    - `id` string, required
    - `properties` object, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nationgraph/apis/nationgraph-api.md) · [All operations](https://skmtc.net/nationgraph/apis/nationgraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nationgraph/nationgraph-api/revisions/85804e68d86d/schema)