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

# Search Contacts

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

Search for contacts using various filters.

## Path parameters

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

## Query parameters

- `query` string, nullable — Text search across searchable properties
- `email` string, nullable — Filter by email
- `firstname` string, nullable — Filter by first name
- `lastname` string, nullable — Filter by last name
- `phone` string, nullable — Filter by phone
- `company` string, nullable — Filter by company name
- `jobtitle` string, nullable — Filter by job title
- `city` string, nullable — Filter by city
- `state` string, nullable — Filter by state
- `country` string, nullable — Filter by country
- `owner_id` string, nullable — Filter by CRM owner ID
- `limit` integer — Number of results
- `after` string, nullable — Pagination cursor
- `properties` string, nullable — Comma-separated list of properties to return

## Response `200`

Successful Response

- ContactSearchResponse — API response for searching contacts.
  - `total` integer, required
  - `results` AppRoutesV3CrmContactsContactResponse[], required
    - `id` string, required
    - `properties` object, required
    - `created_at` string, nullable
    - `updated_at` string, nullable
  - `has_more` boolean
  - `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/versions/85804e68d86d/schema)