Контур.Фокус API: Найти компанию по названию

Сценарий из mcp-everything. Актуально на 2026-10-25.

Когда ИНН неизвестен: подсказки при вводе, затем выбор нужной организации и запрос реквизитов.

1. При посимвольном вводе вызывай GET /api3/suggest?q=... — в ответе тип (UL/IP), наименование, адрес, ИНН, ОГРН, статус.
2. Для полноценного поиска (название, ФИО руководителя, учредитель, адрес) — GET /api2/search?q=... с фильтром region и страницами page (до 10 результатов на странице, не больше 50 страниц).
3. По выбранному ИНН или ОГРН запроси GET /api3/req.

curl "https://focus-api.kontur.ru/api3/suggest?key=$FOCUS_KEY&q=контур"

curl "https://focus-api.kontur.ru/api2/search?key=$FOCUS_KEY&q=газпром&region=66&page=1"

Базовые URL

• Боевой: https://focus-api.kontur.ru

Авторизация

Тип: API-ключ

Ключ доступа передаётся параметром key в строке запроса. Тестовый ключ выдают по заявке: https://focus.kontur.ru/site/api/order-api. Для ключей с лимитом больше 100 000 компаний или запросов обязателен второй фактор: ограничение по IP-диапазонам или подпись каждого запроса сертификатом (настраивает техподдержка, focus-api@kontur.ru).

Методы сценария

GET /api3/req — Базовые реквизиты

Актуальные и исторические реквизиты ЮЛ и ИП. Ответ — массив: inn, ogrn, focusHref, UL (kpp, okpo, opf, legalName.short, legalName.full, legalAddress, branches, status, registrationDate, dissolutionDate, heads[], managementCompanies, history) или IP (fio, okpo, opf и др.).

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2Freq

Параметр	Где	Тип	Обяз.	Описание
key	query	string	да	Ключ доступа
inn	query	string	нет	ИНН, до 100 через запятую; обязателен, если нет ОГРН
ogrn	query	string	нет	ОГРН, до 100 через запятую; обязателен, если нет ИНН
xml	query	boolean	нет	true — ответ в XML (по умолчанию false)

GET /api3/suggest — Поисковые подсказки

В ответе: type (UL, IP), shortName, longName, fio, address, inn, ogrn, kpp, status.

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2Fsuggest

Параметр	Где	Тип	Обяз.	Описание
key	query	string	да	Ключ доступа
q	query	string	да	Поисковый запрос
xml	query	boolean	нет	Ответ в XML

GET /api2/search — Поиск компаний

Поиск по наименованию, ФИО руководителя, учредителю, адресу. В ответе count и items[]: type, shortName, longName, activityText, address, inn, kpp, ogrn, fio, statusText.

Документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi2%2Fsearch

Параметр	Где	Тип	Обяз.	Описание
key	query	string	да	Ключ доступа
q	query	string	да	Поисковый запрос
region	query	string	нет	Код региона 01–99
page	query	string	нет	Страница (до 10 результатов), по умолчанию 1, максимум 50
xml	query	boolean	нет	Ответ в XML

Нюансы

• Большинство методов принимают ИНН или ОГРН и до 100 значений через запятую; ответ — массив по каждой компании.
• Формат по умолчанию JSON; xml=true переключает на XML (методы наблюдения — только JSON).
• focusHref ведёт в веб-карточку Фокуса — для неё нужна подписка на сервис.
• Методы /api3/analytics и /api3/buh устарели: используйте группу новых аналитических методов и /api3/accountingReports.
• Старое наблюдение (/api3/monList, /api3/req/mon, /api3/egrDetails/mon) поддерживается, но рекомендуется NEW Наблюдение (monitoringList, monitoringGetStates, monitoringGetChanges).
• Изменения в NEW Наблюдении хранятся 90 дней; changeId растёт, но не обязательно подряд.
• Самозанятые: лимит считается по уникальным ИНН в сутки (сброс в 00:00 UTC); с 21:00 до 00:00 МСК возможны техработы.
• Есть игровой стенд с формами методов (например, https://focus-api.kontur.ru/api3/req/userform).

Другие сценарии

• Заполнить реквизиты контрагента по ИНН
• Проверить надёжность контрагента перед сделкой
• Проверить пакет контрагентов
• Отслеживать изменения у контрагентов
• Проверить статус самозанятого

---

Если этого недостаточно — официальная документация: https://developer.kontur.ru/doc/focus-v2 Вся интеграция одним документом: https://mcp-everything.ru/integrations/kontur-focus.md