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

# Simple Search Companies

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

Simple search for companies using query parameters.

**For complex filtering with AND/OR logic, custom properties, or advanced operators,
use `POST /crm/{integration_id}/companies/search` instead.**

## Available Filters

All filters are ANDed together (all must match):

- `query`: Full-text search across searchable properties
- `name`: Filter by company name (partial match with wildcards)
- `domain`: Filter by exact domain
- `industry`: Filter by industry
- `city`, `state`, `country`: Location filters
- `owner_id`: Filter by CRM owner

## Custom Properties

Request custom properties using the `properties` parameter:
```
GET /crm/{integration_id}/companies/search?name=acme&properties=name,domain,my_custom_property
```

## Rate Limit

5 requests/second/account

## Path parameters

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

## Query parameters

- `query` string, nullable — Text search across searchable properties
- `name` string, nullable — Filter by company name
- `domain` string, nullable — Filter by domain
- `industry` string, nullable — Filter by industry
- `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
- `nationgraph_id` string, nullable — Filter by NationGraph institution unique_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

- CompanySearchResponse — API response for searching companies.
  - `total` integer, required
  - `results` CompanyResponse[], 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/revisions/85804e68d86d/schema)