API сведений об организациях

JSON по HTTPS: карточка организации или ИП по ИНН, поиск юрлиц, списки по ОКВЭД и регионам, справочники. Данные — открытые данные ФНС России и budget.gov.ru на 28.10.2026.

Начало работы

Зарегистрируйтесь и подтвердите e-mail.
Создайте ключ в личном кабинете → API. Ключ показывается один раз — сохраните его.
Передавайте ключ в заголовке Authorization: Bearer <ключ> (или X-Api-Key: <ключ>). Не передавайте ключ в адресе запроса.

Базовый адрес: https://firmoved.ru/api/v1. Все методы — GET, ответы в UTF-8. Cookies и сессии не используются, CORS выключен — вызывайте API со своего сервера, не из браузера.

curl -s -H "Authorization: Bearer fv_ВАШ_КЛЮЧ" https://firmoved.ru/api/v1/company/7707083893

Тарифы и лимиты

Тариф	Запросов в сутки	В секунду на ключ	Цена
Бесплатный (подтверждённый e-mail)	100	5	0 ₽
API «Старт» на 30 дней	10 000	20	1 990,00 ₽ / 30 дн.
API «Бизнес» на 30 дней	100 000	20	7 990,00 ₽ / 30 дн.

Суточный лимит — на аккаунт (все ключи вместе), сбрасывается в 00:00 по Москве. Лимит в секунду — на каждый ключ. В каждом ответе — заголовки X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix-время сброса). При превышении — ответ 429 с заголовком Retry-After (секунды). Тариф оформляется в кабинете; повышение тарифа действует сразу.

Формат ответа

{
  "data": { … } | [ … ],
  "meta": { … },               // для списков: count, next_after, next …
  "source": {
    "attribution": "Сведения из открытых данных ФНС России и budget.gov.ru …",
    "sources": [{"name": "…", "url": "https://www.nalog.gov.ru/opendata/"}, …],
    "data_date": "2026-10-28",
    "terms": "https://firmoved.ru/offer#data-licence"
  }
}

Поле source есть в каждом ответе, включая ошибки. При публикации данных указывайте источники (см. условия).

Методы

GET /company/{inn} — карточка по ИНН

Юридическое лицо (ИНН из 10 цифр): ОГРН, КПП (если опубликован), наименования, ОКВЭД, регион, населённый пункт, адрес (если опубликован в реестре), категория МСП, показатели: численность, доходы и расходы, спецрежимы, уплаченные налоги, задолженность.

Индивидуальный предприниматель (12 цифр): только открытые сведения ЕГРИП-типа — ФИО как наименование, ОГРНИП, ОКВЭД, регион, категория МСП. Контакты, руководители и учредители-физлица через API не выдаются.

curl -s -H "Authorization: Bearer fv_ВАШ_КЛЮЧ" https://firmoved.ru/api/v1/company/7707083893

{"data": {"inn": "7707083893", "kind": "UL", "ogrn": "1027700132195", "name": "ПАО СБЕРБАНК",
  "okved": {"code": "64.19", "name": "Денежное посредничество прочее"}, "okved_extra": [ … ],
  "region": {"code": "77", "name": "Москва"}, "msp": null, "is_active": true,
  "stats": {"employees": …, "revenue": …, "finance_year": …, "tax_regimes": [], … }, … },
 "source": { … }}

GET /search?q= — поиск юрлиц

По части названия (слова от 3 букв), ИНН (10 цифр) или ОГРН (13 цифр). До 20 результатов, только юридические лица.

curl -s -G -H "Authorization: Bearer fv_ВАШ_КЛЮЧ" --data-urlencode "q=ромашка" https://firmoved.ru/api/v1/search

GET /okved/{code}/companies — юрлица по ОКВЭД

Код включает всю ветку (62 — и 62.01, и 62.09; буква — раздел). Только действующие юрлица, по 100 на страницу. Параметры: region — код субъекта (см. /regions), msp — 0 (не МСП), 1, 2, 3; after — ИНН последней строки предыдущей страницы (значение meta.next_after).

curl -s -H "Authorization: Bearer fv_ВАШ_КЛЮЧ" "https://firmoved.ru/api/v1/okved/62.01/companies?region=77&msp=1"
curl -s -H "Authorization: Bearer fv_ВАШ_КЛЮЧ" "https://firmoved.ru/api/v1/okved/62.01/companies?region=77&msp=1&after=7701234567"

GET /okved и GET /regions — справочники

Коды ОКВЭД 2 с названиями, уровнем, родителем и числом действующих юрлиц и ИП (параметр parent — только дочерние коды); субъекты РФ с числом юрлиц и ИП.

curl -s -H "Authorization: Bearer fv_ВАШ_КЛЮЧ" "https://firmoved.ru/api/v1/okved?parent=62"
curl -s -H "Authorization: Bearer fv_ВАШ_КЛЮЧ" https://firmoved.ru/api/v1/regions

GET /usage — тариф и расход лимита

curl -s -H "Authorization: Bearer fv_ВАШ_КЛЮЧ" https://firmoved.ru/api/v1/usage

Ошибки

{"error": {"code": "quota_exceeded", "message": "Суточный лимит тарифа … исчерпан …"}, "source": { … }}

HTTP	code	Когда
401	`missing_api_key`	ключ не передан
401	`invalid_api_key`	ключ не найден
401	`revoked_api_key`	ключ отозван владельцем
403	`key_blocked`, `account_blocked`, `email_not_verified`	ключ или аккаунт заблокированы, e-mail не подтверждён
404	`not_found`	нет такой организации, кода ОКВЭД или метода
405	`method_not_allowed`	метод не GET
422	`invalid_parameter`	неверный параметр запроса
429	`rate_limited`	больше разрешённого числа запросов в секунду (`Retry-After: 1`)
429	`quota_exceeded`	исчерпан суточный лимит (`Retry-After` — до 00:00 МСК)
503	`service_unavailable`	временная перегрузка — повторите позже
500	`server_error`	внутренняя ошибка

Условия

Данные можно использовать в своих целях и продуктах; перепродавать или раздавать исходный набор данных как самостоятельный продукт нельзя; при публикации указывайте источники. Запрещены обход лимитов (в том числе несколькими аккаунтами), передача ключа третьим лицам и использование сведений для рассылок без согласия адресатов. Подробно — в оферте и пользовательском соглашении. Нужен файл целиком — выгрузка в CSV/XLSX.