# Контур.Фокус API: GET /api3/monitoringGetStates — Полные состояния по списку

В ответе: `changeId`, `inn`, `ogrn`, `isDissolvedMoreThanTTL`, `responseFromApiMethod` (полный ответ по схеме метода).

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

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `key` | query | string | да | Ключ доступа |
| `method` | query | string | да | req или egrDetails |
| `ogrn` | query | string | да | ОГРН, до 100 через запятую |

## Базовые URL

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

## Авторизация

Тип: API-ключ

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

## Нюансы

- Большинство методов принимают ИНН или ОГРН и до 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://mcp-everything.ru/integrations/kontur-focus/scenarios/otslezhivat-izmeneniya-u-kontragentov.md)

---

Если этого недостаточно — официальная документация: https://developer.kontur.ru/doc/focus-v2/method?type=get&path=%2Fapi3%2FmonitoringGetStates
Вся интеграция одним документом: https://mcp-everything.ru/integrations/kontur-focus.md
