{"service": "ibizi", "description": "Сведения о российских налогоплательщиках из открытых данных Федеральной налоговой службы: кто это, чем занимается, какие показатели, как выглядит на фоне отрасли.", "queries": [{"name": "company", "title": "Сведения о налогоплательщике", "description": "Всё, что известно об организации или предпринимателе по ИНН: наименование, регион, вид деятельности, налоговый режим, выручка и расходы, численность работников, задолженность, уплаченные налоги, категория в реестре малого предпринимательства, признаки риска.", "url": "/v1/company", "schema": {"type": "object", "properties": {"inn": {"type": "string", "description": "ИНН: 10 цифр у организации, 12 у предпринимателя", "examples": ["7725800335"]}}, "required": ["inn"]}, "example": {"url": "/v1/company?inn=7725800335"}}, {"name": "search", "title": "Поиск налогоплательщиков", "description": "Подбор организаций и предпринимателей по признакам: вид деятельности, регион, налоговый режим, границы выручки и численности, наличие задолженности. Отвечает на вопросы вида «малые ИТ-компании Казани с выручкой от десяти миллионов» — то, ради чего обычно и нужна база.", "url": "/v1/search", "schema": {"type": "object", "properties": {"okved": {"type": "string", "description": "Код вида деятельности; достаточно первых цифр («62» — вся разработка, «62.01» — только программирование)", "examples": ["62"]}, "region": {"type": "string", "description": "Код субъекта — первые две цифры ИНН", "examples": ["77"]}, "regime": {"type": "string", "description": "Налоговый режим: usn, eshn, ausn, osno", "examples": ["usn"]}, "revenue_from": {"type": "number", "description": "Выручка за год не меньше, рублей"}, "revenue_to": {"type": "number", "description": "Выручка за год не больше, рублей"}, "employees_from": {"type": "integer", "description": "Работников не меньше"}, "with_debt": {"type": "boolean", "description": "Только с задолженностью перед бюджетом"}, "limit": {"type": "integer", "description": "Сколько строк вернуть, не больше 1000", "default": 50}}, "required": []}, "example": {"url": "/v1/search?okved=62&region=16&revenue_from=10000000"}}, {"name": "benchmark", "title": "Ориентиры по отрасли", "description": "Медиана и границы по виду деятельности: выручка, выручка на работника, задолженность. Отвечает на вопрос «много это или мало для такого бизнеса» — сырое число сам по себе ничего не значит.", "url": "/v1/benchmark", "schema": {"type": "object", "properties": {"okved": {"type": "string", "description": "Код вида деятельности; берётся класс (первые две цифры)", "examples": ["62"]}, "region": {"type": "string", "description": "Код субъекта; по умолчанию по всей стране"}}, "required": ["okved"]}, "example": {"url": "/v1/benchmark?okved=62"}}, {"name": "compare", "title": "Сравнение налогоплательщика с отраслью", "description": "Где организация стоит относительно тех, кто занимается тем же: по выручке, по выручке на работника, по долговой нагрузке. Это и есть ответ на вопрос «стоит ли иметь с ней дело», который из сырых цифр не виден.", "url": "/v1/compare", "schema": {"type": "object", "properties": {"inn": {"type": "string", "description": "ИНН организации", "examples": ["7725800335"]}}, "required": ["inn"]}, "example": {"url": "/v1/compare?inn=7725800335"}}, {"name": "industries", "title": "Виды деятельности", "description": "Чем занимаются налогоплательщики: сколько организаций и предпринимателей в каждом виде деятельности, с медианной выручкой. Годится и как справочник кодов, и как обзор рынка.", "url": "/v1/industries", "schema": {"type": "object", "properties": {"region": {"type": "string", "description": "Код субъекта; по умолчанию по стране"}, "limit": {"type": "integer", "description": "Сколько видов вернуть", "default": 25}}, "required": []}, "example": {"url": "/v1/industries?region=77&limit=10"}}, {"name": "regions", "title": "Налогоплательщики по регионам", "description": "Сколько налогоплательщиков в каждом субъекте, сколько среди них должников и на какую сумму.", "url": "/v1/regions", "schema": {"type": "object", "properties": {"limit": {"type": "integer", "description": "Сколько регионов вернуть", "default": 30}}, "required": []}, "example": {"url": "/v1/regions?limit=10"}}, {"name": "history", "title": "Отчётность организации по годам", "description": "Бухгалтерская отчётность из государственного ресурса: выручка, прибыль, активы по годам. Динамика — то, чего нет в обычных выгрузках: рост выручки при падающей прибыли виден только так.", "url": "/v1/history", "schema": {"type": "object", "properties": {"inn": {"type": "string", "description": "ИНН организации", "examples": ["0814131130"]}}, "required": ["inn"]}, "example": {"url": "/v1/history?inn=0814131130"}}, {"name": "stats", "title": "Сводка по всей базе", "description": "Сколько всего налогоплательщиков, какие суммы, какие режимы.", "url": "/v1/stats", "schema": {"type": "object", "properties": {}, "required": []}, "example": {"url": "/v1/stats"}}, {"name": "address_risk", "title": "Адрес массовой регистрации", "description": "Числится ли адрес среди адресов массовой регистрации и сколько организаций на нём зарегистрировано. Совпадение приблизительное: идентификатора адреса в открытых данных нет, сопоставление идёт по написанию.", "url": "/v1/address_risk", "schema": {"type": "object", "properties": {"address": {"type": "string", "description": "Адрес в свободном виде: «Москва, Тверская 10» или «Адыгея Майкоп Гагарина 7»", "examples": ["Москва Тверская 1"]}}, "required": ["address"]}, "example": {"url": "/v1/address_risk?address=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0+%D0%A2%D0%B2%D0%B5%D1%80%D1%81%D0%BA%D0%B0%D1%8F+1"}}, {"name": "mass_person", "title": "Массовый учредитель или руководитель", "description": "Числится ли физическое лицо учредителем или руководителем более чем в десяти организациях — признак, по которому налоговая отказывает в регистрации и оспаривает сделки. Проверяется по ИНН человека; состава участников организаций в открытых данных нет, поэтому обратная проверка «кто владеет этой компанией» невозможна.", "url": "/v1/mass_person", "schema": {"type": "object", "properties": {"inn": {"type": "string", "description": "ИНН физического лица, 12 цифр", "examples": ["550300914931"]}}, "required": ["inn"]}, "example": {"url": "/v1/mass_person?inn=550300914931"}}, {"name": "address_search", "title": "Поиск в адресном справочнике", "description": "Поиск по государственному адресному реестру: субъекты, районы, города, посёлки, улицы. Нужен, чтобы привести написание адреса к официальному и узнать код региона.", "url": "/v1/address_search", "schema": {"type": "object", "properties": {"name": {"type": "string", "description": "Название или его часть", "examples": ["Майкоп"]}, "level": {"type": "integer", "description": "Уровень: 1 субъект, 5 город, 6 населённый пункт, 8 улица"}, "region": {"type": "string", "description": "Код субъекта, чтобы сузить поиск"}, "limit": {"type": "integer", "description": "Сколько строк вернуть", "default": 20}}, "required": ["name"]}, "example": {"url": "/v1/address_search?name=%D0%9C%D0%B0%D0%B9%D0%BA%D0%BE%D0%BF&level=5"}}, {"name": "key_rate", "title": "Ключевая ставка Банка России", "description": "Ставка на дату или весь ряд значений с датами действия. Нужна для расчёта процентов по статье 395 Гражданского кодекса и пеней по налогам.", "url": "/v1/key_rate", "schema": {"type": "object", "properties": {"date": {"type": "string", "description": "Дата в виде 2026-07-27; без неё возвращается весь ряд", "examples": ["2026-07-27"]}}, "required": []}, "example": {"url": "/v1/key_rate?date=2026-07-27"}}, {"name": "bank", "title": "Банк по БИК", "description": "Участник расчётов по коду: наименование, корреспондентский счёт, город. Из справочника Банка России, обновляется каждый операционный день.", "url": "/v1/bank", "schema": {"type": "object", "properties": {"bic": {"type": "string", "description": "Банковский идентификационный код, 9 цифр", "examples": ["044525225"]}}, "required": ["bic"]}, "example": {"url": "/v1/bank?bic=044525225"}}]}