# CRM search

Find a contact, company, lead or deal with one request. Use [Search](./crm-search/search.md) for a name, phone number or email address.

- Route: `POST /v1/crm/search`
- Bitrix24 method: `crm.entity.search`
- Key scope: `crm`; READONLY keys work.

The response contains at most **20 results across all types**, without pagination. `meta.limits` identifies types omitted by Bitrix24 tariff restrictions. By default, companies marked `IS_MY_COMPANY=Y` are excluded.
