{"openapi": "3.0.3", "info": {"title": "Реестр реестров: API «Допуски контрагента»", "version": "1.0.0", "description": "Лицензии, членство в СРО, аккредитации, записи в отраслевых и финансовых реестрах по ИНН. Данные выгружаются из открытых источников ведомств; у каждой записи ссылка на первоисточник и дата выгрузки. Сведения не являются официальной выпиской. Без ключа 10 запросов в день с IP; бесплатный ключ 100 запросов в день: https://reestr-reestrov.ru/kabinet/. Тарифы Старт, Бизнес и Корпоративный добавляют проверку по ИНН без лимита по IP, массовую проверку (/api/v1/check/bulk), мониторинг с вебхуками и расширенные карточки реестров. Документация: https://reestr-reestrov.ru/api-dostupy/", "contact": {"email": "info@reestr-reestrov.ru", "url": "https://reestr-reestrov.ru/api-dostupy/"}}, "servers": [{"url": "https://reestr-reestrov.ru"}], "components": {"securitySchemes": {"ApiKey": {"type": "apiKey", "in": "header", "name": "X-API-Key"}}, "schemas": {"Record": {"type": "object", "properties": {"status": {"type": "string", "enum": ["active", "suspended", "terminated", "unknown"], "description": "active: действует; suspended: приостановлена; terminated: прекращена, аннулирована, исключён; unknown: статус в источнике не указан"}, "number": {"type": "string", "nullable": true, "description": "Номер лицензии, записи, регистрационный номер"}, "date_from": {"type": "string", "format": "date", "nullable": true}, "date_to": {"type": "string", "format": "date", "nullable": true}, "name": {"type": "string", "nullable": true, "description": "Наименование организации так, как оно записано в реестре"}, "extra": {"type": "object", "additionalProperties": true, "description": "Поля конкретного реестра: вид работ, уровень ответственности, регион, исходный текст статуса (status_text)"}, "url": {"type": "string", "nullable": true, "description": "Страница записи или реестра на официальном сайте"}}}, "SourceResult": {"type": "object", "properties": {"id": {"type": "string"}, "title": {"type": "string"}, "agency": {"type": "string"}, "mode": {"type": "string", "enum": ["bulk", "live"]}, "found": {"type": "boolean"}, "active": {"type": "integer"}, "total": {"type": "integer", "description": "Если записей больше 50"}, "records": {"type": "array", "items": {"$ref": "#/components/schemas/Record"}}, "source_url": {"type": "string"}, "updated_at": {"type": "string", "description": "Когда реестр выгружен с сайта ведомства (bulk) или время запроса (live)"}, "error": {"type": "string", "enum": ["unavailable", "not_loaded"], "description": "Источник не ответил: found в этом случае не означает отсутствие записи"}}}, "Permits": {"type": "object", "properties": {"inn": {"type": "string"}, "name": {"type": "string", "nullable": true}, "checked_at": {"type": "string", "format": "date-time"}, "found_in": {"type": "integer"}, "sources": {"type": "array", "items": {"$ref": "#/components/schemas/SourceResult"}}, "unknown_sources": {"type": "array", "items": {"type": "string"}}}}, "Change": {"type": "object", "properties": {"id": {"type": "integer"}, "source_id": {"type": "string"}, "source_title": {"type": "string"}, "at": {"type": "string"}, "kind": {"type": "string", "enum": ["added", "removed", "changed"]}, "before": {"type": "object", "nullable": true}, "after": {"type": "object", "nullable": true}}}, "Error": {"type": "object", "properties": {"error": {"type": "string"}, "message": {"type": "string"}, "limit": {"type": "integer"}}}}}, "security": [{"ApiKey": []}, {}], "paths": {"/api/v1/permits": {"get": {"summary": "Допуски по ИНН", "operationId": "getPermits", "parameters": [{"name": "inn", "in": "query", "required": true, "schema": {"type": "string", "pattern": "^(\\d{10}|\\d{12})$"}, "example": "7707083893"}, {"name": "sources", "in": "query", "required": false, "schema": {"type": "string"}, "description": "id источников через запятую (список: /api/v1/sources). Без параметра: все источники", "example": "nostroy,nopriz"}], "responses": {"200": {"description": "Результат по каждому источнику", "headers": {"X-RateLimit-Limit": {"schema": {"type": "string"}}, "X-RateLimit-Remaining": {"schema": {"type": "string"}}, "X-RateLimit-Period": {"schema": {"type": "string"}}, "X-Plan": {"schema": {"type": "string"}}}, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Permits"}}}}, "400": {"description": "Неверный ИНН"}, "401": {"description": "Неверный ключ"}, "429": {"description": "Лимит исчерпан", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}}}}, "/api/v1/sources": {"get": {"summary": "Источники: дата обновления и число записей", "operationId": "getSources", "security": [{}], "responses": {"200": {"description": "Список источников"}}}}, "/api/v1/changes": {"get": {"summary": "Изменения по ИНН (сравнение ежедневных снимков)", "operationId": "getChanges", "parameters": [{"name": "inn", "in": "query", "required": true, "schema": {"type": "string", "pattern": "^(\\d{10}|\\d{12})$"}, "example": "7707083893"}, {"name": "since", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "description": "С какой даты (по умолчанию 30 дней назад)"}], "responses": {"200": {"description": "Изменения", "content": {"application/json": {"schema": {"type": "object", "properties": {"inn": {"type": "string"}, "since": {"type": "string"}, "changes": {"type": "array", "items": {"$ref": "#/components/schemas/Change"}}}}}}}, "429": {"description": "Лимит исчерпан", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}}}}, "/api/v1/usage": {"get": {"summary": "Тариф и расход запросов по ключу", "operationId": "getUsage", "security": [{"ApiKey": []}], "responses": {"200": {"description": "Расход"}, "401": {"description": "Нужен ключ"}}}}, "/api/v1/watch": {"get": {"summary": "Список ИНН для уведомлений об изменениях", "operationId": "getWatch", "security": [{"ApiKey": []}], "responses": {"200": {"description": "Список"}}}, "post": {"summary": "Добавить или убрать ИНН (Старт: 100, Бизнес: 1000)", "operationId": "setWatch", "security": [{"ApiKey": []}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"inn": {"type": "string"}, "remove": {"type": "boolean"}}}}}}, "responses": {"200": {"description": "Список"}, "403": {"description": "Тариф не позволяет"}}}}, "/api/v1/webhook": {"post": {"summary": "Вебхук на изменения (Бизнес). Подпись X-Signature: sha256=HMAC_SHA256(secret, body)", "operationId": "setWebhook", "security": [{"ApiKey": []}], "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"url": {"type": "string", "description": "https-адрес; пустая строка отключает"}}}}}}, "responses": {"200": {"description": "Секрет для проверки подписи"}, "403": {"description": "Тариф не позволяет"}}}}, "/api/v1/check": {"get": {"summary": "Проверка по ИНН: ЕГРЮЛ/ЕГРИП, МСП, Федресурс, операторы ПДн, РНП, лицензии. Старт 10 000, Бизнес 100 000 в месяц; бесплатный ключ 6 в минуту и 300 в сутки с IP", "operationId": "checkInn", "security": [{"ApiKey": []}], "parameters": [{"name": "inn", "in": "query", "required": true, "schema": {"type": "string", "pattern": "^(\\d{10}|\\d{12})$"}, "example": "7707083893"}], "responses": {"200": {"description": "Результат по каждому источнику; у недоступного источника поле error"}, "400": {"description": "Неверный ИНН"}, "401": {"description": "Нужен ключ"}, "429": {"description": "Лимит"}}}}, "/api/v1/check/bulk": {"post": {"summary": "Массовая проверка списка ИНН (Старт до 1 000, Бизнес до 10 000, Корпоративный до 50 000 за пакет), асинхронно", "operationId": "bulkSubmit", "security": [{"ApiKey": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["inns"], "properties": {"inns": {"oneOf": [{"type": "array", "items": {"type": "string"}}, {"type": "string"}], "description": "Массив ИНН или строка с ИНН через запятую или перенос строки. Дубли и неверные ИНН отбрасываются и не списываются"}, "fast": {"type": "boolean", "default": false, "description": "Без выписки ЕГРЮЛ (лицензий): в 3 раза быстрее"}, "notify": {"type": "boolean", "default": true, "description": "Вебхук bulk.done по завершении (Бизнес, Корпоративный, если задан /api/v1/webhook)"}}}, "example": {"inns": ["7707083893", "7736207543"], "fast": true}}}}, "responses": {"202": {"description": "Пакет принят", "content": {"application/json": {"schema": {"type": "object", "properties": {"job_id": {"type": "string"}, "status": {"type": "string", "enum": ["queued", "running", "done"]}, "total": {"type": "integer"}, "done": {"type": "integer"}, "rejected": {"type": "array", "items": {"type": "string"}}, "status_url": {"type": "string"}, "csv_url": {"type": "string"}, "results": {"type": "array", "items": {"type": "object", "properties": {"inn": {"type": "string"}, "status": {"type": "string", "enum": ["ok", "error"]}, "checked_at": {"type": "string"}, "result": {"type": "object", "description": "Как ответ /api/v1/check"}}}}}}}}}, "403": {"description": "Тариф не позволяет"}, "413": {"description": "Больше лимита пакета"}, "429": {"description": "Лимит проверок или очереди"}}}, "get": {"summary": "Пакеты ключа за 7 дней", "operationId": "bulkList", "security": [{"ApiKey": []}], "responses": {"200": {"description": "Список"}}}}, "/api/v1/check/bulk/{job_id}": {"get": {"summary": "Статус и результаты пакета (JSON страницами или CSV целиком, разделитель «;», UTF-8 с BOM)", "operationId": "bulkGet", "security": [{"ApiKey": []}], "parameters": [{"name": "job_id", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "format", "in": "query", "schema": {"type": "string", "enum": ["json", "csv"], "default": "json"}}, {"name": "offset", "in": "query", "schema": {"type": "integer", "default": 0}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 500, "maximum": 1000}}], "responses": {"200": {"description": "Пакет", "content": {"application/json": {"schema": {"type": "object", "properties": {"job_id": {"type": "string"}, "status": {"type": "string", "enum": ["queued", "running", "done"]}, "total": {"type": "integer"}, "done": {"type": "integer"}, "rejected": {"type": "array", "items": {"type": "string"}}, "status_url": {"type": "string"}, "csv_url": {"type": "string"}, "results": {"type": "array", "items": {"type": "object", "properties": {"inn": {"type": "string"}, "status": {"type": "string", "enum": ["ok", "error"]}, "checked_at": {"type": "string"}, "result": {"type": "object", "description": "Как ответ /api/v1/check"}}}}}}}, "text/csv": {"schema": {"type": "string"}}}}, "404": {"description": "Нет такого пакета"}}}}, "/api/v1/events": {"get": {"summary": "События мониторинга по списку /api/v1/watch: ЕГРЮЛ/ЕГРИП, МСП, Федресурс, РНП, лицензии (check) и отраслевые реестры (permits)", "operationId": "getEvents", "security": [{"ApiKey": []}], "parameters": [{"name": "since", "in": "query", "schema": {"type": "string", "format": "date"}, "description": "По умолчанию 30 дней назад"}, {"name": "inn", "in": "query", "schema": {"type": "string"}, "description": "Только по одному ИНН из списка"}], "responses": {"200": {"description": "События"}, "403": {"description": "Тариф не позволяет"}}}}, "/api/v1/catalog/export": {"get": {"summary": "Весь каталог госреестров с расширенными карточками (Корпоративный тариф)", "operationId": "catalogExport", "security": [{"ApiKey": []}], "responses": {"200": {"description": "Каталог"}, "403": {"description": "Тариф не позволяет"}}}}}}