{"openapi": "3.1.0", "info": {"title": "Prism Hub", "version": "1", "description": "Ответ о субъекте по реестровому якорю, с явной разметкой того, чего мы не знаем.", "license": {"name": "Открытые данные ФНС России, реестр МСП"}}, "servers": [{"url": "https://prismfact.com"}], "paths": {"/ask": {"get": {"summary": "проверка: всё, что знаем про известный ИНН", "description": "проверка: всё, что знаем про известный ИНН", "parameters": [{"name": "inn", "in": "query", "description": "обязательный; несколько ИНН через запятую — до 100 за раз, ответ в том же порядке", "required": true, "schema": {"type": "string"}}, {"name": "want", "in": "query", "description": "необязательный, список полей или групп через запятую", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Факты с провенансом. Отсутствие размечено: found, none, unknown, not_provided.", "content": {"application/json": {"schema": {"type": "object"}}}}, "503": {"description": "Данные ещё загружаются, повторите"}}}}, "/inn/{inn}": {"get": {"summary": "то же, что /ask, но постоянным адресом: единица цитирования. На параметр запроса сослаться нельзя, на адрес записи можно", "description": "то же, что /ask, но постоянным адресом: единица цитирования. На параметр запроса сослаться нельзя, на адрес записи можно — её кладут в текст и в чужую базу", "parameters": [{"name": "want", "in": "query", "description": "необязательный, список полей через запятую", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "Факты с провенансом. Отсутствие размечено: found, none, unknown, not_provided.", "content": {"application/json": {"schema": {"type": "object"}}}}, "503": {"description": "Данные ещё загружаются, повторите"}}}}, "/nearby": {"get": {"summary": "слой карты: что стоит вокруг точки. Отвечает на вопрос, который задают углу дома, — реестр на него ответить не может. Эт", "description": "слой карты: что стоит вокруг точки. Отвечает на вопрос, который задают углу дома, — реестр на него ответить не может. Это заведения, а не субъекты реестра: вывеска юридически не существует, связь с ИНН не установлена ни для одного места", "parameters": [{"name": "lat", "in": "query", "description": "широта, обязательный", "required": true, "schema": {"type": "number"}}, {"name": "lon", "in": "query", "description": "долгота, обязательный", "required": true, "schema": {"type": "number"}}, {"name": "radius_m", "in": "query", "description": "радиус в метрах, по умолчанию 500, потолок 20000", "required": false, "schema": {"type": "integer"}}, {"name": "q", "in": "query", "description": "подстрока в названии заведения", "required": false, "schema": {"type": "string"}}, {"name": "category", "in": "query", "description": "категория 2ГИС, например Аптеки", "required": false, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "description": "размер страницы", "required": false, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Факты с провенансом. Отсутствие размечено: found, none, unknown, not_provided.", "content": {"application/json": {"schema": {"type": "object"}}}}, "503": {"description": "Данные ещё загружаются, повторите"}}}}, "/find": {"get": {"summary": "обнаружение: что есть на территории по виду деятельности. Проверку продают все, обнаружение не продаёт никто — на него н", "description": "обнаружение: что есть на территории по виду деятельности. Проверку продают все, обнаружение не продаёт никто — на него нельзя ответить, не имея множества целиком", "parameters": [{"name": "okved", "in": "query", "description": "код или его начало, например 45.2", "required": false, "schema": {"type": "string"}}, {"name": "settlement", "in": "query", "description": "населённый пункт, например Асино", "required": false, "schema": {"type": "string"}}, {"name": "district", "in": "query", "description": "муниципальный район", "required": false, "schema": {"type": "string"}}, {"name": "type", "in": "query", "description": "UL или IP; регистр не важен, чужое значение вернёт отказ со списком", "required": false, "schema": {"type": "string"}}, {"name": "category", "in": "query", "description": "1 микро, 2 малое, 3 среднее; принимаются и слова micro/small/medium, микро/малое/среднее", "required": false, "schema": {"type": "string"}}, {"name": "changed_since", "in": "query", "description": "только те, у кого что-то изменилось или кто появился", "required": false, "schema": {"type": "string"}}, {"name": "q", "in": "query", "description": "подстрока в названии, ИНН или коде деятельности", "required": false, "schema": {"type": "string"}}, {"name": "headcount_min", "in": "query", "description": "среднесписочная численность не ниже указанной", "required": false, "schema": {"type": "string"}}, {"name": "revenue_min", "in": "query", "description": "доход за отчётный год не ниже указанного, рублей", "required": false, "schema": {"type": "string"}}, {"name": "has_tax_debt", "in": "query", "description": "1 — только с задолженностью по налогам, 0 — только без неё", "required": false, "schema": {"type": "string"}}, {"name": "regime", "in": "query", "description": "налоговый режим: УСН, ЕСХН, АУСН, СРП", "required": false, "schema": {"type": "string"}}, {"name": "sort", "in": "query", "description": "name · okved · since · headcount · revenue · tax_debt", "required": false, "schema": {"type": "string"}}, {"name": "offset", "in": "query", "description": "сдвиг страницы, по умолчанию 0", "required": false, "schema": {"type": "integer"}}, {"name": "limit", "in": "query", "description": "размер страницы, по умолчанию 50, потолок 500", "required": false, "schema": {"type": "integer"}}], "responses": {"200": {"description": "Факты с провенансом. Отсутствие размечено: found, none, unknown, not_provided.", "content": {"application/json": {"schema": {"type": "object"}}}}, "503": {"description": "Данные ещё загружаются, повторите"}}}}, "/health": {"get": {"summary": "Готовность сервера", "responses": {"200": {"description": "Состояние и число загруженных срезов"}}}}}}