{"openapi":"3.1.0","info":{"title":"hintdata.ru API","version":"0.1.0","summary":"Подсказки, точный поиск и геолокация по адресам, организациям и банкам.","description":"Методы принимают JSON и отвечают JSON. Ключ передаётся в заголовке\n`Authorization: Token <ключ>`.\n\nТело ошибки — `{\"error\": \"<код>\"}`; коды перечислены у каждого статуса.\n"},"externalDocs":{"description":"Документация на сайте","url":"https://hintdata.ru/docs"},"servers":[{"url":"https://api.hintdata.ru"}],"tags":[{"name":"address","x-displayName":"Адреса","description":"Подсказки адресов, адрес по коду, по координатам и город по IP."},{"name":"party","x-displayName":"Организации","description":"Компании и индивидуальные предприниматели."},{"name":"bank","x-displayName":"Банки","description":"Кредитные организации."}],"paths":{"/v1/suggest/address":{"post":{"operationId":"suggestAddress","tags":["address"],"summary":"Подсказки адреса","description":"До 20 адресов из ГАР, подходящих к введённому тексту.","x-hintdata-keys":["pk","sk"],"x-hintdata-scope":"suggest:address","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressSuggestRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/AddressSuggestOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/find/address":{"post":{"operationId":"findAddressById","tags":["address"],"summary":"Адрес по идентификатору","description":"Один адрес по коду ФИАС, коду КЛАДР или кадастровому номеру.","x-hintdata-keys":["sk"],"x-hintdata-scope":"find:address","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressFindByIdRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/AddressFindByIdOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/geolocate/address":{"post":{"operationId":"geolocateAddress","tags":["address"],"summary":"Адрес по координатам","description":"Ближайшие адреса в заданном радиусе от точки.","x-hintdata-keys":["pk","sk"],"x-hintdata-scope":"geolocate","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressGeolocateRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/AddressGeolocateOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/iplocate/address":{"get":{"operationId":"iplocateAddress","tags":["address"],"summary":"Город по IP","description":"Город по IP-адресу. IP берётся из параметра `ip`; без него — первый адрес из заголовка\n`X-Forwarded-For`, а без него — IP того, кто вызывает. Ответ содержит `location: null`,\nесли город не определён.\n","x-hintdata-keys":["pk","sk"],"x-hintdata-scope":"suggest:address","security":[{"TokenAuth":[]}],"parameters":[{"$ref":"#/components/parameters/IpQuery"}],"responses":{"200":{"$ref":"#/components/responses/AddressIplocateOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}},"post":{"operationId":"iplocateAddressPost","tags":["address"],"summary":"Город по IP (POST)","description":"То же, что GET. IP можно передать параметром `ip` — в строке запроса или в теле; без него\nберётся первый адрес из заголовка `X-Forwarded-For`, а без него — IP того, кто вызывает.\nПараметр в строке запроса приоритетнее поля в теле.\n","x-hintdata-keys":["pk","sk"],"x-hintdata-scope":"suggest:address","security":[{"TokenAuth":[]}],"parameters":[{"$ref":"#/components/parameters/IpQuery"}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressIplocateRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/AddressIplocateOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/suggest/party":{"post":{"operationId":"suggestParty","tags":["party"],"summary":"Подсказки организаций","description":"Компании и ИП по названию, ИНН, ОГРН, адресу или ФИО.","x-hintdata-keys":["pk","sk"],"x-hintdata-scope":"suggest:party","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartySuggestRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/PartySuggestOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/find/party":{"post":{"operationId":"findPartyById","tags":["party"],"summary":"Организация по ИНН или ОГРН","description":"Все записи под ИНН или ОГРН: головная организация первой, затем подразделения.\nКПП можно передать отдельно или в `query` через косую черту: `7707083893/540602001`.\n","x-hintdata-keys":["sk"],"x-hintdata-scope":"suggest:party","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyFindByIdRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/PartyFindByIdOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/find/party-affiliated":{"post":{"operationId":"findPartyAffiliated","tags":["party"],"summary":"Связанные организации","description":"Организации, где лицо с этим ИНН — учредитель или руководитель.","x-hintdata-keys":["sk"],"x-hintdata-scope":"suggest:party","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyFindAffiliatedRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/PartyFindAffiliatedOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/find/party-by-email":{"post":{"operationId":"findPartyByEmail","tags":["party"],"summary":"Организация по email","description":"Организации, у которых в реестре указан этот адрес почты.","x-hintdata-keys":["sk"],"x-hintdata-scope":"suggest:party","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyFindByEmailRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/PartyFindByEmailOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/suggest/bank":{"post":{"operationId":"suggestBank","tags":["bank"],"summary":"Подсказки банков","description":"Банки по названию, БИК или SWIFT.","x-hintdata-keys":["pk","sk"],"x-hintdata-scope":"suggest:refs","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankSuggestRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/BankSuggestOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/find/bank":{"post":{"operationId":"findBankById","tags":["bank"],"summary":"Банк по БИК","description":"Один банк по точному БИК.","x-hintdata-keys":["sk"],"x-hintdata-scope":"find:refs","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankFindByIdRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/BankFindByIdOk"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/find/phone":{"post":{"operationId":"findPhone","tags":["phone"],"summary":"Проверка номера и оператора","description":"Тип номера, регион и часовой пояс — на любом тарифе. Оператор, перенос, ИНН и MCC/MNC — при гранте phone_mnp на тарифах «Бизнес» и «Корпоративный». Поля без гранта исключаются из карточки. Запрос расходует дневной лимит: один номер — одна единица, включая пакет. Метод нативный; совместимого findById/phone у DaData нет.","x-hintdata-keys":["sk"],"x-hintdata-scope":"find:phone","security":[{"TokenAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneFindRequest"},"examples":{"single":{"value":{"query":"89627302371"}},"batch":{"value":{"items":["89627302371","не номер"],"mask":"e164"}}}}}},"responses":{"200":{"$ref":"#/components/responses/PhoneFindOk"},"400":{"description":"Невалидный JSON, нет строки query/массива items или в пакете больше 1000 элементов.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["invalid_json","query_or_items_required","too_many_items"]},"max":{"type":"integer","const":1000}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/BadGateway"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/account":{"get":{"operationId":"getAccount","tags":["account"],"summary":"Лимиты ключа и баланс аккаунта","description":"Возвращает лимиты запросов и денежный баланс аккаунта. Требуется секретный API-ключ. Запрос бесплатный и не расходует квоты. Обновление баланса может занимать до 10 секунд.","x-hintdata-keys":["sk"],"security":[{"TokenAuth":[]}],"responses":{"200":{"$ref":"#/components/responses/AccountOk"},"401":{"$ref":"#/components/responses/AccountUnauthorized"},"403":{"$ref":"#/components/responses/AccountForbidden"},"503":{"$ref":"#/components/responses/AccountBillingUnavailable"}}}}},"components":{"securitySchemes":{"TokenAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Значение заголовка — `Token <ключ>`.\n\n- `pk_…` — публичный ключ для браузера и виджетов: подсказки и геолокация.\n- `sk_…` — секретный ключ только для сервера: все методы, включая точный поиск.\n\nПоиск по идентификатору, связям и почте принимает только секретный ключ.\n"}},"parameters":{"IpQuery":{"name":"ip","in":"query","required":false,"description":"IPv4 или IPv6. Без него берётся `ip` из тела POST, затем первый адрес из заголовка\n`X-Forwarded-For`, затем IP того, кто вызывает.\n","schema":{"type":"string"}}},"schemas":{"Count20":{"type":"integer","minimum":1,"maximum":20,"default":10,"description":"Сколько записей вернуть. Значение вне диапазона приводится к ближайшей границе."},"Count300":{"type":"integer","minimum":1,"maximum":300,"default":10,"description":"Сколько записей вернуть. Значение вне диапазона приводится к ближайшей границе."},"AddressValueStyle":{"type":"string","enum":["natural","fias"],"default":"natural","description":"Форма строки `value`:\n- `natural` — читаемая: «Шолоховский р-н, Газовый пер»;\n- `fias` — форма ГАР, тип перед именем: «р-н Шолоховский, пер Газовый».\n"},"AddressLevel":{"type":"string","enum":["region","area","city","settlement","street","house","flat","stead","room","carplace"],"description":"Уровень адреса:\n- `region` — регион;\n- `area` — район;\n- `city` — город;\n- `settlement` — населённый пункт вне города;\n- `street` — улица;\n- `house` — дом;\n- `flat` — квартира или помещение;\n- `stead` — земельный участок;\n- `room` — комната;\n- `carplace` — машино-место.\n"},"AddressBound":{"type":"object","required":["value"],"properties":{"value":{"$ref":"#/components/schemas/AddressLevel"}}},"AddressLocation":{"type":"object","description":"Условие по территории. Поля внутри одного объекта объединяются через И, объекты массива — через ИЛИ.\nЧисловые коды можно передавать числом.\n","properties":{"kladr_id":{"type":"string","description":"Код КЛАДР любого уровня; уровень определяется по структуре кода."},"fias_id":{"type":"string","description":"Код ФИАС объекта."},"region_kladr_id":{"type":"string"},"area_kladr_id":{"type":"string"},"city_kladr_id":{"type":"string"},"settlement_kladr_id":{"type":"string"},"street_kladr_id":{"type":"string"},"region_fias_id":{"type":"string"},"area_fias_id":{"type":"string"},"city_fias_id":{"type":"string"},"settlement_fias_id":{"type":"string"},"street_fias_id":{"type":"string"},"territory_fias_id":{"type":"string","description":"Код ФИАС территории (парк, СНТ, квартал) — адреса внутри неё."},"house_fias_id":{"type":"string","description":"Код ФИАС дома — помещения внутри него."},"postal_code":{"type":"string"},"okato":{"type":"string"},"oktmo":{"type":"string"},"region":{"type":"string","description":"Название региона."},"area":{"type":"string","description":"Название района."},"city":{"type":"string","description":"Название города."},"settlement":{"type":"string","description":"Название населённого пункта."},"street":{"type":"string","description":"Название улицы."}}},"GeoCircle":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"radius_meters":{"type":"integer","minimum":1,"maximum":100000,"default":100}}},"OmitNull":{"type":"boolean","default":false,"description":"Убрать из ответа ключи со значением `null` на любой глубине. Пустые массивы, пустые строки, `0` и `false` остаются. Ключи, обязательные по схеме ответа, тоже пропадают, если их значение `null`."},"AddressSuggestRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Текст запроса. Учитываются первые 220 символов."},"count":{"$ref":"#/components/schemas/Count20"},"locations":{"type":"array","maxItems":20,"description":"Жёсткий фильтр — только адреса из указанных территорий. Учитываются первые 20.","items":{"$ref":"#/components/schemas/AddressLocation"}},"locations_boost":{"type":"array","maxItems":20,"description":"Поднимает адреса указанных территорий, не отсекая остальные. Учитываются первые 20.","items":{"$ref":"#/components/schemas/AddressLocation"}},"locations_geo":{"type":"array","maxItems":10,"description":"Только адреса внутри окружностей. Учитываются первые 10.","items":{"$ref":"#/components/schemas/GeoCircle"}},"from_bound":{"$ref":"#/components/schemas/AddressBound"},"to_bound":{"$ref":"#/components/schemas/AddressBound"},"division":{"type":"string","enum":["administrative","municipal"],"default":"administrative","description":"Деление, в котором вернуть адрес."},"ip":{"type":"string","description":"IP пользователя. Если локации не заданы, поднимает адреса его региона."},"value_style":{"$ref":"#/components/schemas/AddressValueStyle"},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"AddressFindByIdRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Код ФИАС, код КЛАДР или кадастровый номер."},"value_style":{"$ref":"#/components/schemas/AddressValueStyle"},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"AddressGeolocateRequest":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Широта."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Долгота."},"count":{"$ref":"#/components/schemas/Count20"},"radius_meters":{"type":"integer","minimum":1,"maximum":1000,"default":100,"description":"Радиус поиска в метрах. Значение вне диапазона приводится к ближайшей границе."},"value_style":{"$ref":"#/components/schemas/AddressValueStyle"},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"AddressIplocateRequest":{"type":"object","properties":{"ip":{"type":"string","description":"IPv4 или IPv6. Используется, если в строке запроса нет параметра `ip`."},"value_style":{"$ref":"#/components/schemas/AddressValueStyle"},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"PartyType":{"type":"string","enum":["LEGAL","INDIVIDUAL"],"description":"- `LEGAL` — юридическое лицо;\n- `INDIVIDUAL` — индивидуальный предприниматель.\n"},"PartyStatus":{"type":"string","enum":["ACTIVE","LIQUIDATING","LIQUIDATED","REORGANIZING","BANKRUPT"],"description":"- `ACTIVE` — действующая;\n- `LIQUIDATING` — ликвидируется;\n- `LIQUIDATED` — ликвидирована;\n- `REORGANIZING` — в процессе присоединения к другому юрлицу;\n- `BANKRUPT` — банкротство.\n"},"PartyBranchType":{"type":"string","enum":["MAIN","BRANCH"],"description":"- `MAIN` — головная организация;\n- `BRANCH` — филиал или представительство.\n"},"PartyLocation":{"type":"object","description":"Регион организации. Достаточно одного из полей.","properties":{"region":{"type":"string","description":"Двузначный код региона, например `77`."},"kladr_id":{"type":"string","description":"Код КЛАДР; учитываются первые две цифры — код региона."}}},"PartySuggestRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Название, ИНН, ОГРН, адрес или ФИО."},"count":{"$ref":"#/components/schemas/Count20"},"type":{"$ref":"#/components/schemas/PartyType"},"branch_type":{"$ref":"#/components/schemas/PartyBranchType"},"status":{"type":"array","description":"Только организации в этих состояниях.","items":{"$ref":"#/components/schemas/PartyStatus"}},"okved":{"type":"array","description":"Только организации с этими кодами ОКВЭД (основным или дополнительным).","items":{"type":"string"}},"locations":{"type":"array","description":"Жёсткий фильтр — только организации указанных регионов.","items":{"$ref":"#/components/schemas/PartyLocation"}},"locations_boost":{"type":"array","description":"Поднимает организации указанных регионов, не отсекая остальные.","items":{"$ref":"#/components/schemas/PartyLocation"}},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"PartyFindByIdRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"ИНН или ОГРН; можно `ИНН/КПП`."},"count":{"$ref":"#/components/schemas/Count300"},"kpp":{"type":"string","description":"КПП подразделения. Приоритетнее КПП из `query`."},"branch_type":{"$ref":"#/components/schemas/PartyBranchType"},"type":{"$ref":"#/components/schemas/PartyType"},"status":{"type":"array","description":"Только записи в этих состояниях.","items":{"$ref":"#/components/schemas/PartyStatus"}},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"AffiliatedScope":{"type":"string","enum":["MANAGERS","FOUNDERS"],"description":"- `MANAGERS` — лицо руководит организацией;\n- `FOUNDERS` — лицо входит в учредители.\n"},"PartyFindAffiliatedRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"ИНН учредителя или руководителя."},"count":{"$ref":"#/components/schemas/Count300"},"scope":{"type":"array","description":"Какие связи искать. Без поля — обе.","items":{"$ref":"#/components/schemas/AffiliatedScope"}},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"PartyFindByEmailRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Адрес электронной почты."},"count":{"$ref":"#/components/schemas/Count300"},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"BankSuggestRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Название банка, БИК или SWIFT."},"count":{"$ref":"#/components/schemas/Count20"},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"BankFindByIdRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"БИК."},"omit_null":{"$ref":"#/components/schemas/OmitNull"}}},"AddressSuggestResponse":{"type":"object","properties":{"query":{"type":"string","description":"Текст запроса."},"suggestions":{"type":"array","description":"Найденные записи, сначала самые подходящие.","items":{"$ref":"#/components/schemas/Address"}}},"required":["query","suggestions"]},"AddressFindByIdResponse":{"type":"object","properties":{"query":{"type":"string","description":"Идентификатор из запроса."},"suggestions":{"type":"array","description":"Найденный адрес: одна запись или пустой список.","items":{"$ref":"#/components/schemas/Address"}}},"required":["query","suggestions"]},"AddressGeolocateResponse":{"type":"object","properties":{"query":{"type":"string","description":"Текст запроса."},"suggestions":{"type":"array","description":"Адреса в радиусе, сначала ближайшие.","items":{"$ref":"#/components/schemas/Address"}}},"required":["query","suggestions"]},"AddressIplocateResponse":{"type":"object","properties":{"location":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"description":"Город, к которому относится IP; `null`, если город не определён."},"network":{"$ref":"#/components/schemas/IpNetwork","description":"Сеть, которой принадлежит IP. Есть, только если сеть известна."}},"required":["location"]},"PartySuggestResponse":{"type":"object","properties":{"query":{"type":"string","description":"Текст запроса."},"suggestions":{"type":"array","description":"Найденные записи, сначала самые подходящие.","items":{"$ref":"#/components/schemas/Party"}}},"required":["query","suggestions"]},"PartyFindByIdResponse":{"type":"object","properties":{"query":{"type":"string","description":"ИНН или ОГРН из запроса."},"suggestions":{"type":"array","description":"Все записи под ИНН или ОГРН: головная организация первой, затем подразделения.","items":{"$ref":"#/components/schemas/Party"}}},"required":["query","suggestions"]},"PartyFindAffiliatedResponse":{"type":"object","properties":{"query":{"type":"string","description":"ИНН из запроса."},"suggestions":{"type":"array","description":"Организации, где лицо — учредитель или руководитель.","items":{"$ref":"#/components/schemas/Party"}}},"required":["query","suggestions"]},"PartyFindByEmailResponse":{"type":"object","properties":{"query":{"type":"string","description":"Адрес почты из запроса."},"suggestions":{"type":"array","description":"Организации с этим адресом почты.","items":{"$ref":"#/components/schemas/Party"}}},"required":["query","suggestions"]},"BankSuggestResponse":{"type":"object","properties":{"query":{"type":"string","description":"Текст запроса."},"suggestions":{"type":"array","description":"Найденные записи, сначала самые подходящие.","items":{"$ref":"#/components/schemas/Bank"}}},"required":["query","suggestions"]},"BankFindByIdResponse":{"type":"object","properties":{"query":{"type":"string","description":"БИК из запроса."},"suggestions":{"type":"array","description":"Найденный банк: одна запись или пустой список.","items":{"$ref":"#/components/schemas/Bank"}}},"required":["query","suggestions"]},"Address":{"type":"object","properties":{"value":{"type":"string","description":"Адрес одной строкой для показа и подстановки в поле ввода."},"full":{"type":"string","description":"Полная форма адреса: с регионом и почтовым индексом."},"level":{"type":"string","description":"До какого уровня детализирован адрес.\n\n- `region` — регион;\n- `area` — район;\n- `city` — город;\n- `settlement` — населённый пункт;\n- `street` — улица;\n- `house` — дом;\n- `flat` — квартира или помещение;\n- `stead` — земельный участок;\n- `room` — комната;\n- `carplace` — машино-место;\n- `other` — прочий объект ГАР, например территория (СНТ, ГСК, квартал).\n","enum":["region","area","city","settlement","street","house","flat","stead","room","carplace","other"]},"is_active":{"type":"boolean","description":"`false` — объект снят с учёта в ГАР: снесён или упразднён."},"confidence":{"type":"number","description":"Насколько вероятно, что это нужный адрес, от 0 до 1. Низкое значение у адреса с номером дома — признак, что такого дома нет. Есть в подсказках и в городе по IP."},"federal_district":{"type":"string","description":"Федеральный округ."},"address":{"$ref":"#/components/schemas/AddressParts","description":"Адрес строками по уровням. Приходят только заполненные уровни."},"components":{"$ref":"#/components/schemas/AddressComponents","description":"Уровни адреса объектами с названием, типом и кодами. Приходят только заполненные уровни."},"codes":{"$ref":"#/components/schemas/AddressCodes","description":"Коды адреса в классификаторах."},"fias_id":{"type":"string","description":"Код ФИАС самого детального уровня адреса (UUID)."},"fias_level":{"type":"integer","description":"Уровень адреса по ФИАС: 1 — регион, 3 — район, 4 — город, 6 — населённый пункт, 7 — улица, 65 — планировочная структура, 75 — земельный участок, 8 — дом, 9 — квартира или помещение, 10 — комната, 95 — машино-место."},"geo":{"$ref":"#/components/schemas/AddressGeo","description":"Координаты и их точность. Нет — координаты неизвестны."},"timezone":{"type":"string","description":"Часовой пояс, например `UTC+3`. Зависит от тарифа.","x-hintdata-plan":"address_premium"},"metro":{"type":"array","description":"Ближайшие станции метро, до трёх. Зависит от тарифа.","x-hintdata-plan":"address_premium","items":{"$ref":"#/components/schemas/MetroStation"}},"beltway_hit":{"type":"string","description":"Положение относительно кольцевой дороги Москвы или Санкт-Петербурга. Есть только в этих регионах. Зависит от тарифа.\n\n- `IN_MKAD` — внутри МКАД;\n- `OUT_MKAD` — за МКАД;\n- `IN_KAD` — внутри КАД;\n- `OUT_KAD` — за КАД.\n","enum":["IN_MKAD","OUT_MKAD","IN_KAD","OUT_KAD"],"x-hintdata-plan":"address_extended"},"beltway_distance":{"type":"integer","description":"Расстояние от кольцевой дороги, км. Есть только у адресов за кольцевой. Зависит от тарифа.","x-hintdata-plan":"address_extended"},"cadastral_num":{"type":"string","description":"Кадастровый номер объекта. Зависит от тарифа.","x-hintdata-plan":"address_cadastral"},"cadastre":{"$ref":"#/components/schemas/CadastreProfile","description":"Сведения ЕГРН об объекте. Зависит от тарифа.","x-hintdata-plan":"address_cadastral"},"cadastral_cost":{"type":"number","format":"decimal","description":"Кадастровая стоимость объекта, ₽. Не рыночная цена. Зависит от тарифа.","x-hintdata-plan":"address_cadastral"},"cadastral_cost_per_unit":{"type":"number","format":"decimal","description":"Кадастровая стоимость за м², ₽. Зависит от тарифа.","x-hintdata-plan":"address_cadastral"},"match":{"$ref":"#/components/schemas/AddressMatch","description":"Совпадение с уровнями, названными в запросе. Только в подсказках."},"capital_marker":{"type":"string","description":"Признак административного центра у населённого пункта адреса: 1 — центр района, 2 — центр региона, 3 — центр и района, и региона, 4 — центральный район региона. Нет признака — поля нет."},"flat_area":{"type":"number","description":"Площадь квартиры или помещения, м². Зависит от тарифа.","x-hintdata-plan":"address_premium"},"history_values":{"type":"array","description":"Прежние названия объекта.","items":{"type":"string","description":"Прежнее название."}}},"required":["value","full","level","is_active","address","components","codes","fias_id","fias_level"]},"IpNetwork":{"type":"object","properties":{"asn":{"type":"integer","description":"Номер автономной системы (ASN)."},"operator":{"type":"string","description":"Оператор — владелец автономной системы."},"type":{"type":"string","description":"Тип сети.\n\n- `isp` — провайдер;\n- `mobile` — мобильный оператор;\n- `hosting` — дата-центр или хостинг;\n- `business` — корпоративная сеть.\n","enum":["isp","mobile","hosting","business"]},"is_hosting":{"type":"boolean","description":"`true` — IP принадлежит хостингу или дата-центру."}},"required":["asn","operator","type","is_hosting"]},"Party":{"type":"object","properties":{"value":{"type":"string","description":"Название компании или ФИО предпринимателя для показа."},"inn":{"type":"string","description":"ИНН: 10 цифр у компании, 12 у предпринимателя."},"ogrn":{"type":"string","description":"ОГРН компании или ОГРНИП предпринимателя."},"kpp":{"type":["string","null"],"description":"КПП.","x-hintdata-when":{"type":["LEGAL"]}},"type":{"type":["string","null"],"description":"Вид записи.\n\n- `LEGAL` — юридическое лицо;\n- `INDIVIDUAL` — индивидуальный предприниматель.\n","enum":["LEGAL","INDIVIDUAL",null]},"name":{"type":"object","description":"Наименование.","properties":{"full":{"type":["string","null"],"description":"Полное наименование с правовой формой."},"short":{"type":["string","null"],"description":"Краткое наименование с правовой формой."},"latin":{"type":["string","null"],"description":"Наименование латиницей."},"clean":{"type":["string","null"],"description":"Краткое наименование без правовой формы и кавычек — для подстановки в форму."}},"required":["full","short","latin","clean"]},"opf":{"type":"object","description":"Организационно-правовая форма.","properties":{"code":{"type":["string","null"],"description":"Код ОКОПФ."},"short":{"type":["string","null"],"description":"Сокращение: «ООО», «ИП»."},"full":{"type":["string","null"],"description":"Полное название формы."},"type":{"type":"string","description":"Версия справочника ОКОПФ.","enum":["2014"]}},"required":["code","short","full","type"]},"okveds":{"type":["array","null"],"description":"Виды деятельности. Основной код есть на любом тарифе, остальные зависят от тарифа.","x-hintdata-plan":"party_extended","items":{"type":"object","description":"Вид деятельности.","properties":{"code":{"type":"string","description":"Код ОКВЭД."},"name":{"type":["string","null"],"description":"Наименование. Нет, если код не найден в справочнике."},"main":{"type":"boolean","description":"`true` — основной вид деятельности."},"type":{"type":["string","null"],"description":"Редакция ОКВЭД. Зависит от тарифа.","x-hintdata-plan":"party_extended","enum":["2001","2014",null]}},"required":["code","name","main","type"]}},"address":{"$ref":"#/components/schemas/PartyAddress","description":"Адрес регистрации."},"state":{"type":"object","description":"Состояние.","properties":{"status":{"type":"string","description":"Статус.\n\n- `ACTIVE` — действующая;\n- `LIQUIDATING` — ликвидируется;\n- `LIQUIDATED` — ликвидирована;\n- `BANKRUPT` — банкротство;\n- `REORGANIZING` — в процессе присоединения к другому юрлицу.\n","enum":["ACTIVE","LIQUIDATING","LIQUIDATED","BANKRUPT","REORGANIZING"]},"code":{"type":["string","null"],"description":"Код состояния по справочнику ЕГРЮЛ или ЕГРИП, например `105` — предстоящее исключение."},"name":{"type":["string","null"],"description":"Текст состояния по реестру. Есть, если заполнен код состояния."},"exclusion_decision":{"type":["object","null"],"description":"Решение о предстоящем исключении из ЕГРЮЛ. Зависит от тарифа.","x-hintdata-plan":"party_premium","properties":{"date":{"type":["string","null"],"description":"Дата решения. Дата в формате `ГГГГ-ММ-ДД`."},"number":{"type":["string","null"],"description":"Номер решения."}},"required":["date","number"]},"egrul_changed_at":{"type":["string","null"],"description":"Дата последней записи в реестре. Дата в формате `ГГГГ-ММ-ДД`."},"actuality_date":{"type":["string","null"],"description":"Дата актуальности сведений. Дата в формате `ГГГГ-ММ-ДД`."},"registration_date":{"type":["string","null"],"description":"Дата регистрации. Дата в формате `ГГГГ-ММ-ДД`."},"liquidation_date":{"type":["string","null"],"description":"Дата ликвидации. Дата в формате `ГГГГ-ММ-ДД`."}},"required":["status","code","name","egrul_changed_at","actuality_date","registration_date","liquidation_date"]},"ogrn_date":{"type":["string","null"],"description":"Дата присвоения ОГРН. Дата в формате `ГГГГ-ММ-ДД`."},"invalid":{"type":["object","null"],"description":"Отметка ФНС о недостоверности сведений. Нет отметки — `null`. Зависит от тарифа.","x-hintdata-when":{"type":["LEGAL"]},"x-hintdata-plan":"party_premium","properties":{"code":{"type":["string","null"],"description":"Код причины по справочнику ФНС: `1` — заявление лица, `2` — проверка налоговой, `3` — решение суда."},"name":{"type":["string","null"],"description":"Текст причины."},"date":{"type":["string","null"],"description":"Дата отметки. Дата в формате `ГГГГ-ММ-ДД`."}},"required":["code","name","date"]},"codes":{"type":"object","description":"Коды статистики.","properties":{"okpo":{"type":["string","null"],"description":"Код ОКПО."},"okato":{"type":["string","null"],"description":"Код ОКАТО."},"oktmo":{"type":["string","null"],"description":"Код ОКТМО."},"okogu":{"type":["string","null"],"description":"Код ОКОГУ."},"okfs":{"type":["string","null"],"description":"Код ОКФС."}},"required":["okpo","okato","oktmo","okogu","okfs"]},"kpp_largest":{"type":["string","null"],"description":"КПП крупнейшего налогоплательщика. Не заполняется.","x-hintdata-when":{"type":["LEGAL"]},"x-hintdata-filled":false},"branch_type":{"type":"string","description":"Головная организация или подразделение.\n\n- `MAIN` — головная организация;\n- `BRANCH` — филиал;\n- `REPRESENTATIVE` — представительство.\n","enum":["MAIN","BRANCH","REPRESENTATIVE"],"x-hintdata-when":{"type":["LEGAL"]}},"branch_count":{"type":["integer","null"],"description":"Число подразделений. У подразделения — 0.","x-hintdata-when":{"type":["LEGAL"]}},"management":{"type":["object","null"],"description":"Руководитель.","x-hintdata-when":{"type":["LEGAL"]},"properties":{"name":{"type":"string","description":"ФИО или наименование руководителя."},"inn":{"type":["string","null"],"description":"ИНН руководителя — лица из полного состава `managers` с тем же именем. Только в методах `/v1/find/*`, в подсказке поля нет. Лица нет в составе, у него нет ИНН или у двух лиц с этим именем разные ИНН — `null`. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"post":{"type":["string","null"],"description":"Должность."},"post_type":{"type":["string","null"],"description":"Вид должности по справочнику ЕГРЮЛ, например «Руководитель юридического лица»."},"start_date":{"type":["string","null"],"description":"Дата, с которой сведения о руководителе в реестре. Дата в формате `ГГГГ-ММ-ДД`."},"disqualified":{"type":["object","null"],"description":"Запись о дисквалификации руководителя. Нет записи — `null`. Зависит от тарифа.","x-hintdata-plan":"party_premium","properties":{"article":{"type":["string","null"],"description":"Статья КоАП."},"authority":{"type":["string","null"],"description":"Орган, вынесший решение."},"date_start":{"type":["string","null"],"description":"Начало срока дисквалификации. Дата в формате `ГГГГ-ММ-ДД`."},"date_end":{"type":["string","null"],"description":"Окончание срока дисквалификации. Дата в формате `ГГГГ-ММ-ДД`."},"active":{"type":["boolean","null"],"description":"`true` — дисквалификация действует сейчас."}}}},"required":["name","post","post_type","start_date"]},"capital":{"type":["object","null"],"description":"Уставный капитал. Только в поиске по ИНН, ОГРН, связям и почте. Зависит от тарифа.","x-hintdata-when":{"type":["LEGAL"]},"x-hintdata-plan":"party_premium","properties":{"type":{"type":["string","null"],"description":"Вид капитала."},"value":{"type":"number","description":"Сумма, ₽.","format":"decimal"}},"required":["type","value"]},"revenue":{"type":["number","null"],"format":"decimal","description":"Выручка за последний год, ₽. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"smb":{"type":["object","null"],"description":"Запись в реестре малого и среднего бизнеса.","properties":{"category":{"type":"string","description":"Категория.\n\n- `MICRO` — микропредприятие;\n- `SMALL` — малое;\n- `MEDIUM` — среднее.\n","enum":["MICRO","SMALL","MEDIUM"]},"issued_at":{"type":["string","null"],"description":"Дата включения в реестр. Дата в формате `ГГГГ-ММ-ДД`."}},"required":["category","issued_at"]},"employee_count":{"type":["integer","null"],"description":"Среднесписочная численность работников. Зависит от тарифа.","x-hintdata-plan":"party_extended"},"founders":{"type":["array","null"],"description":"Учредители. Зависит от тарифа.","x-hintdata-when":{"type":["LEGAL"]},"x-hintdata-plan":"party_premium","items":{"$ref":"#/components/schemas/PartyFounder"}},"managers":{"type":["array","null"],"description":"Руководители. Зависит от тарифа.","x-hintdata-when":{"type":["LEGAL"]},"x-hintdata-plan":"party_premium","items":{"$ref":"#/components/schemas/PartyManager"}},"tax_regimes":{"type":["array","null"],"description":"Специальные налоговые режимы по-русски: «УСН», «ЕСХН», «ПСН», «НПД», «АУСН». Зависит от тарифа.","x-hintdata-plan":"party_extended","items":{"type":"string","description":"Режим."}},"finance":{"type":["array","null"],"description":"Бухгалтерская отчётность по годам, сначала последний. Зависит от тарифа.","x-hintdata-plan":"party_premium","items":{"$ref":"#/components/schemas/PartyFinanceYear"}},"fns":{"type":"object","description":"Сведения налоговой.","properties":{"tax_mode":{"type":["array","null"],"description":"Режимы налогообложения кодами. Зависит от тарифа.","x-hintdata-plan":"party_premium","items":{"type":"string","description":"Режим.\n\n- `osn` — общая система;\n- `usn` — упрощённая;\n- `eshn` — сельскохозяйственный налог;\n- `ausn` — автоматизированная упрощённая;\n- `srp` — соглашение о разделе продукции;\n- `psn` — патент;\n- `npd` — налог на профессиональный доход.\n","enum":["osn","usn","eshn","ausn","srp","psn","npd"]}},"debt":{"type":["number","null"],"format":"decimal","description":"Задолженность по налогам, ₽. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"penalty":{"type":["number","null"],"format":"decimal","description":"Неуплаченные штрафы, ₽. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"income":{"type":["number","null"],"format":"decimal","description":"Доходы за год `fns.year` по данным налоговой, ₽. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"expense":{"type":["number","null"],"format":"decimal","description":"Расходы за год `fns.year` по данным налоговой, ₽. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"year":{"type":["integer","null"],"description":"Год, к которому относятся доходы и расходы. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"paid":{"type":["object","null"],"description":"Уплаченные налоги и сборы за последний год. Зависит от тарифа.","x-hintdata-plan":"party_premium","properties":{"items":{"type":"array","description":"Суммы по налогам.","items":{"type":"object","description":"Налог или сбор.","properties":{"name":{"type":"string","description":"Наименование налога."},"sum":{"type":["number","null"],"format":"decimal","description":"Сумма, ₽."}},"required":["name","sum"]}},"total":{"type":["number","null"],"format":"decimal","description":"Всего уплачено, ₽."},"year":{"type":["integer","null"],"description":"Год."}},"required":["items","total","year"]}}},"emails":{"type":["array","null"],"description":"Адреса почты, сначала из реестра. Зависит от тарифа.","x-hintdata-plan":"party_premium","items":{"type":"string","description":"Адрес почты."}},"phones":{"type":["array","null"],"description":"Телефоны. Зависит от тарифа.","x-hintdata-plan":"party_premium","items":{"type":"string","description":"Телефон."}},"sites":{"type":["array","null"],"description":"Сайты. Зависит от тарифа. Не заполняется.","x-hintdata-plan":"party_premium","x-hintdata-filled":false,"items":{"type":"string"}},"licenses":{"type":["array","null"],"description":"Лицензии. Зависит от тарифа.","x-hintdata-plan":"party_premium","items":{"$ref":"#/components/schemas/PartyLicense"}},"authorities":{"type":["object","null"],"description":"Органы, где организация состоит на учёте. Зависит от тарифа.","x-hintdata-plan":"party_extended","properties":{"fts_registration":{"$ref":"#/components/schemas/PartyAuthority","description":"Налоговая по месту регистрации."},"fts_report":{"$ref":"#/components/schemas/PartyAuthority","description":"Налоговая, куда сдаётся отчётность."},"pf":{"$ref":"#/components/schemas/PartyAuthority","description":"Отделение Социального фонда (бывший ПФР)."},"sif":{"$ref":"#/components/schemas/PartyAuthority","description":"Отделение Социального фонда (бывший ФСС)."}},"required":["fts_registration","fts_report","pf","sif"]},"documents":{"type":["object","null"],"description":"Документы об учёте. Зависит от тарифа.","x-hintdata-plan":"party_premium","properties":{"fts_registration":{"anyOf":[{"$ref":"#/components/schemas/PartyDocument"},{"type":"null"}],"description":"Свидетельство о регистрации в налоговой. Не заполняется.","x-hintdata-filled":false},"fts_report":{"anyOf":[{"$ref":"#/components/schemas/PartyDocument"},{"type":"null"}],"description":"Постановка на учёт в налоговой."},"pf_registration":{"anyOf":[{"$ref":"#/components/schemas/PartyDocument"},{"type":"null"}],"description":"Регистрация в Социальном фонде (бывший ПФР)."},"sif_registration":{"anyOf":[{"$ref":"#/components/schemas/PartyDocument"},{"type":"null"}],"description":"Регистрация в Социальном фонде (бывший ФСС)."},"smb":{"type":["object","null"],"description":"Запись в реестре малого и среднего бизнеса.","properties":{"type":{"type":"string","description":"Вид документа.","enum":["SMB"]},"category":{"type":"string","description":"Категория.\n\n- `MICRO` — микропредприятие;\n- `SMALL` — малое;\n- `MEDIUM` — среднее.\n","enum":["MICRO","SMALL","MEDIUM"]},"issue_date":{"type":["string","null"],"description":"Дата включения в реестр. Дата в формате `ГГГГ-ММ-ДД`."}},"required":["type","category","issue_date"]}},"required":["fts_registration","fts_report","pf_registration","sif_registration","smb"]},"predecessors":{"type":["array","null"],"description":"Правопредшественники. Зависит от тарифа.","x-hintdata-when":{"type":["LEGAL"]},"x-hintdata-plan":"party_premium","items":{"$ref":"#/components/schemas/PartyReference"}},"successors":{"type":["array","null"],"description":"Правопреемники. Зависит от тарифа.","x-hintdata-when":{"type":["LEGAL"]},"x-hintdata-plan":"party_premium","items":{"$ref":"#/components/schemas/PartyReference"}},"fio":{"type":["object","null"],"description":"ФИО предпринимателя.","x-hintdata-when":{"type":["INDIVIDUAL"]},"properties":{"surname":{"type":["string","null"],"description":"Фамилия."},"name":{"type":["string","null"],"description":"Имя."},"patronymic":{"type":["string","null"],"description":"Отчество."}},"required":["surname","name","patronymic"]},"citizenship":{"type":["object","null"],"description":"Гражданство предпринимателя. Зависит от тарифа.","x-hintdata-when":{"type":["INDIVIDUAL"]},"x-hintdata-plan":"party_extended","properties":{"code":{"type":"object","description":"Код страны.","properties":{"alpha_3":{"type":["string","null"],"description":"Буквенный код ISO 3166-1 alpha-3."},"numeric":{"type":"string","description":"Цифровой код по ОКСМ."}},"required":["alpha_3","numeric"]},"name":{"type":"object","description":"Название страны.","properties":{"full":{"type":"string","description":"Полное название."},"short":{"type":["string","null"],"description":"Краткое название."}},"required":["full","short"]}},"required":["code","name"]},"gender":{"type":["string","null"],"description":"Пол предпринимателя.\n\n- `MALE` — мужской;\n- `FEMALE` — женский.\n","enum":["MALE","FEMALE",null],"x-hintdata-when":{"type":["INDIVIDUAL"]}},"tax_authority_code":{"type":"string","description":"Код инспекции, где стоит на учёте подразделение. Зависит от тарифа.","x-hintdata-plan":"party_extended","x-hintdata-when":{"type":["LEGAL"],"branch_type":["BRANCH"]}}},"required":["value","inn","ogrn","type","name","opf","address","state","ogrn_date","codes"]},"PartyAddress":{"type":"object","properties":{"value":{"type":["string","null"],"description":"Адрес регистрации одной строкой."},"postal_code":{"type":["string","null"],"description":"Почтовый индекс."},"fias_id":{"type":["string","null"],"description":"Код ФИАС адреса (UUID)."},"region":{"type":["string","null"],"description":"Двузначный код региона, например `77`."},"region_name":{"type":["string","null"],"description":"Регион с типом, например «Московская обл»."},"city":{"type":["string","null"],"description":"Город. Не заполняется.","x-hintdata-filled":false},"full":{"type":"string","description":"Полная форма адреса. Есть, когда адрес разобран по ГАР."},"level":{"type":"string","description":"До какого уровня детализирован адрес. Есть, когда адрес разобран по ГАР.\n\n- `region` — регион;\n- `area` — район;\n- `city` — город;\n- `settlement` — населённый пункт;\n- `street` — улица;\n- `house` — дом;\n- `flat` — квартира или помещение;\n- `stead` — земельный участок;\n- `room` — комната;\n- `carplace` — машино-место;\n- `other` — прочий объект ГАР, например территория (СНТ, ГСК, квартал).\n","enum":["region","area","city","settlement","street","house","flat","stead","room","carplace","other"]},"is_active":{"type":"boolean","description":"`false` — объект снят с учёта в ГАР. Есть, когда адрес разобран по ГАР."},"confidence":{"type":"number","description":"Насколько вероятно, что адрес разобран верно, от 0 до 1."},"federal_district":{"type":"string","description":"Федеральный округ."},"address":{"$ref":"#/components/schemas/AddressParts","description":"Адрес строками по уровням. Приходят только заполненные уровни."},"components":{"$ref":"#/components/schemas/AddressComponents","description":"Уровни адреса объектами с названием, типом и кодами. Приходят только заполненные уровни."},"codes":{"$ref":"#/components/schemas/AddressCodes","description":"Коды адреса в классификаторах."},"fias_level":{"type":"integer","description":"Уровень адреса по ФИАС: 1 — регион, 3 — район, 4 — город, 6 — населённый пункт, 7 — улица, 65 — планировочная структура, 75 — земельный участок, 8 — дом, 9 — квартира или помещение, 10 — комната, 95 — машино-место. Есть, когда адрес разобран по ГАР."},"geo":{"$ref":"#/components/schemas/AddressGeo","description":"Координаты и их точность. Нет — координаты неизвестны."},"timezone":{"type":"string","description":"Часовой пояс, например `UTC+3`. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"capital_marker":{"type":"string","description":"Признак административного центра у населённого пункта адреса: 1 — центр района, 2 — центр региона, 3 — центр и района, и региона, 4 — центральный район региона. Нет признака — поля нет. Приходит строкой или числом."},"metro":{"type":"array","description":"Ближайшие станции метро, до трёх. Зависит от тарифа.","x-hintdata-plan":"party_premium","items":{"$ref":"#/components/schemas/MetroStation"}},"beltway_hit":{"type":"string","description":"Положение относительно кольцевой дороги Москвы или Санкт-Петербурга. Есть только в этих регионах. Зависит от тарифа.\n\n- `IN_MKAD` — внутри МКАД;\n- `OUT_MKAD` — за МКАД;\n- `IN_KAD` — внутри КАД;\n- `OUT_KAD` — за КАД.\n","x-hintdata-plan":"party_extended","enum":["IN_MKAD","OUT_MKAD","IN_KAD","OUT_KAD"]},"beltway_distance":{"type":"integer","description":"Расстояние от кольцевой дороги, км. Есть только у адресов за кольцевой. Зависит от тарифа.","x-hintdata-plan":"party_extended"},"cadastral_num":{"type":"string","description":"Кадастровый номер объекта. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"cadastre":{"$ref":"#/components/schemas/CadastreProfile","description":"Сведения ЕГРН об объекте. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"cadastral_cost":{"type":"number","format":"decimal","description":"Кадастровая стоимость объекта, ₽. Не рыночная цена. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"cadastral_cost_per_unit":{"type":"number","format":"decimal","description":"Кадастровая стоимость за м², ₽. Зависит от тарифа.","x-hintdata-plan":"party_premium"},"flat_area":{"type":"number","description":"Площадь квартиры или помещения, м². Зависит от тарифа.","x-hintdata-plan":"party_premium"},"house_level":{"type":"boolean","description":"Точен ли адрес до дома. Только в поиске по ИНН или ОГРН."},"history_values":{"type":"array","description":"Прежние названия объекта.","items":{"type":"string","description":"Прежнее название."}}},"required":["value","fias_id"]},"Bank":{"type":"object","properties":{"value":{"type":"string","description":"Наименование банка для показа."},"bic":{"type":"string","description":"БИК, 9 цифр."},"correspondent_account":{"type":["string","null"],"description":"Корреспондентский счёт, 20 цифр."},"registration_number":{"type":["string","null"],"description":"Регистрационный номер в Банке России."},"city":{"type":["string","null"],"description":"Город."},"region":{"type":"string","description":"Двузначный код региона."},"address":{"type":["string","null"],"description":"Адрес."},"participant_type":{"type":["string","null"],"description":"Вид участника платёжной системы.\n\n- `head` — головная кредитная организация;\n- `branch` — филиал;\n- `rkc` — подразделение Банка России.\n","enum":["head","branch","rkc",null]},"swift":{"type":["string","null"],"description":"SWIFT-код."},"status":{"type":["string","null"],"description":"Статус в справочнике БИК; прочие статусы Банка России — `null`.\n\n- `ACTIVE` — действует;\n- `LIQUIDATED` — исключён из справочника.\n","enum":["ACTIVE","LIQUIDATED",null]}},"required":["value","bic","correspondent_account","registration_number","city","region","address","participant_type","swift","status"]},"PartyFounder":{"type":"object","properties":{"kind":{"type":"string","description":"Вид учредителя по реестру, например `PERSON` — человек, `LEGAL` — российская организация, `FOREIGN` — иностранная организация."},"type":{"type":["string","null"],"description":"Кто учредитель.\n\n- `LEGAL` — организация;\n- `PHYSICAL` — человек.\n","enum":["LEGAL","PHYSICAL",null]},"ogrn":{"type":["string","null"],"description":"ОГРН — у организации."},"inn":{"type":["string","null"],"description":"ИНН."},"name":{"type":["string","null"],"description":"Наименование организации или ФИО человека."},"fio":{"anyOf":[{"$ref":"#/components/schemas/PersonFio"},{"type":"null"}],"description":"ФИО человека, разобранное на части."},"start_date":{"type":["string","null"],"description":"Дата, с которой сведения в реестре. Дата в формате `ГГГГ-ММ-ДД`."},"share":{"type":["object","null"],"description":"Доля в уставном капитале.","properties":{"denominator":{"type":["integer","null"],"description":"Знаменатель для `FRACTION`."},"numerator":{"type":["integer","null"],"description":"Числитель для `FRACTION`."},"type":{"type":"string","description":"Как задана доля.\n\n- `PERCENT` — в процентах;\n- `DECIMAL` — десятичной дробью;\n- `FRACTION` — простой дробью.\n","enum":["PERCENT","DECIMAL","FRACTION"]},"value":{"type":"number","description":"Размер доли для `PERCENT` и `DECIMAL`.","format":"decimal"}},"required":["denominator","numerator","type","value"]},"country_code":{"type":["string","null"],"description":"Код страны иностранного учредителя по ОКСМ."},"country_name":{"type":["string","null"],"description":"Страна иностранного учредителя."},"foreign_reg_number":{"type":["string","null"],"description":"Регистрационный номер иностранного учредителя в своей стране."},"invalidity":{"anyOf":[{"$ref":"#/components/schemas/PersonInvalidity"},{"type":"null"}],"description":"Отметка о недостоверности сведений."}},"required":["type","ogrn","inn","name","fio","share"]},"PartyManager":{"type":"object","properties":{"ogrn":{"type":["string","null"],"description":"ОГРН — у организации."},"inn":{"type":["string","null"],"description":"ИНН."},"name":{"type":["string","null"],"description":"Наименование организации или ФИО человека."},"fio":{"anyOf":[{"$ref":"#/components/schemas/PersonFio"},{"type":"null"}],"description":"ФИО человека, разобранное на части."},"post":{"type":["string","null"],"description":"Должность."},"post_type":{"type":["string","null"],"description":"Вид должности по справочнику ЕГРЮЛ."},"type":{"type":["string","null"],"description":"Кто руководитель.\n\n- `EMPLOYEE` — человек;\n- `LEGAL` — управляющая организация.\n","enum":["EMPLOYEE","LEGAL",null]},"start_date":{"type":"string","description":"Дата, с которой сведения в реестре. Дата в формате `ГГГГ-ММ-ДД`."},"citizenship_code":{"type":["string","null"],"description":"Код вида гражданства по справочнику ЕГРЮЛ."},"invalidity":{"anyOf":[{"$ref":"#/components/schemas/PersonInvalidity"},{"type":"null"}],"description":"Отметка о недостоверности сведений."},"share":{"type":["object","null"],"description":"Доля в капитале. Не заполняется.","x-hintdata-filled":false}},"required":["ogrn","inn","name","fio","post","type"]},"PersonFio":{"type":"object","properties":{"source":{"type":"string","description":"ФИО как в реестре."},"result":{"type":["string","null"],"description":"ФИО после разбора. Null, если в реестре нет имени."},"surname":{"type":["string","null"],"description":"Фамилия."},"name":{"type":["string","null"],"description":"Имя."},"patronymic":{"type":["string","null"],"description":"Отчество."},"gender":{"type":"string","description":"Пол.\n\n- `М` — мужской;\n- `Ж` — женский;\n- `НД` — не удалось определить.\n","enum":["М","Ж","НД"]},"qc":{"type":"integer","description":"Качество разбора.\n\n- `0` — разобрано уверенно;\n- `1` — разобрано с допущениями, стоит проверить.\n","enum":[0,1]}},"required":["source","result","surname","name","patronymic","gender","qc"]},"PersonInvalidity":{"type":"object","properties":{"code":{"type":"string","description":"Код причины по справочнику ФНС: `1` — заявление лица, `2` — проверка налоговой, `3` — решение суда."},"date":{"type":"string","description":"Дата отметки. Дата в формате `ГГГГ-ММ-ДД`."},"decision":{"type":"string","description":"Текст причины."}},"required":["code","date","decision"]},"PartyLicense":{"type":"object","properties":{"activity":{"type":["string","null"],"description":"Лицензируемый вид деятельности."},"activity_code":{"type":["string","null"],"description":"Код вида деятельности. Не заполняется.","x-hintdata-filled":false},"authority":{"type":["string","null"],"description":"Кто выдал."},"authority_code":{"type":["string","null"],"description":"Код органа, выдавшего лицензию."},"decisions":{"type":"array","description":"Решения по лицензии.","items":{"type":"object","properties":{"kind":{"type":["string","null"],"description":"Вид решения."},"number":{"type":["string","null"],"description":"Номер."},"date":{"type":["string","null"],"description":"Дата. Дата в формате `ГГГГ-ММ-ДД`."},"effective_date":{"type":["string","null"],"description":"Дата вступления в силу. Дата в формате `ГГГГ-ММ-ДД`."},"authority":{"type":["string","null"],"description":"Орган."},"reason":{"type":["string","null"],"description":"Основание."},"status":{"type":["string","null"],"description":"Состояние."}}}},"erul_number":{"type":["string","null"],"description":"Номер в едином реестре лицензий."},"issue_date":{"type":["string","null"],"description":"Дата выдачи. Дата в формате `ГГГГ-ММ-ДД`."},"locations":{"type":"array","description":"Места осуществления деятельности.","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Идентификатор места; на него ссылается `services[].location_id`."},"type":{"type":["string","null"],"description":"Вид места."},"status":{"type":["string","null"],"description":"Состояние."},"address":{"type":["string","null"],"description":"Адрес."},"fias_id":{"type":["string","null"],"description":"Код ФИАС адреса."},"valid_from":{"type":["string","null"],"description":"Начало действия. Дата в формате `ГГГГ-ММ-ДД`."},"valid_to":{"type":["string","null"],"description":"Окончание действия. Дата в формате `ГГГГ-ММ-ДД`."}}}},"number":{"type":["string","null"],"description":"Номер лицензии."},"raw_number":{"type":["string","null"],"description":"Номер как в реестре."},"raw_status":{"type":"string","description":"Состояние как в реестре."},"record_date":{"type":["string","null"],"description":"Дата записи в реестре. Дата в формате `ГГГГ-ММ-ДД`."},"resume_date":{"type":["string","null"],"description":"Дата возобновления. Дата в формате `ГГГГ-ММ-ДД`. Не заполняется.","x-hintdata-filled":false},"series":{"type":["string","null"],"description":"Серия бланка. Не заполняется.","x-hintdata-filled":false},"services":{"type":"array","description":"Работы и услуги по лицензии.","items":{"type":"object","properties":{"location_id":{"type":["string","null"],"description":"Место осуществления из `locations[].id`; нет — услуга по всей лицензии."},"code":{"type":["string","null"],"description":"Код."},"name":{"type":["string","null"],"description":"Наименование."},"description":{"type":["string","null"],"description":"Описание."},"valid_from":{"type":["string","null"],"description":"Начало действия. Дата в формате `ГГГГ-ММ-ДД`."},"valid_to":{"type":["string","null"],"description":"Окончание действия. Дата в формате `ГГГГ-ММ-ДД`."}}}},"source":{"type":"string","description":"Реестр-источник: `fns-egrul` — ЕГРЮЛ, `fns-egrip` — ЕГРИП."},"status":{"type":"string","description":"Состояние, например `active` — действует, `suspended` — приостановлена."},"suspend_date":{"type":["string","null"],"description":"Дата приостановки. Дата в формате `ГГГГ-ММ-ДД`."},"valid_from":{"type":["string","null"],"description":"Начало действия. Дата в формате `ГГГГ-ММ-ДД`."},"valid_to":{"type":["string","null"],"description":"Окончание действия. Дата в формате `ГГГГ-ММ-ДД`."}},"required":["activity","activity_code","authority","authority_code","decisions","erul_number","issue_date","locations","number","raw_number","raw_status","record_date","resume_date","series","services","source","status","suspend_date","valid_from","valid_to"]},"PartyReference":{"type":"object","properties":{"inn":{"type":["string","null"],"description":"ИНН."},"name":{"type":"string","description":"Наименование."},"ogrn":{"type":["string","null"],"description":"ОГРН."}},"required":["inn","name","ogrn"]},"PartyFinanceYear":{"type":"object","properties":{"year":{"type":"integer","description":"Отчётный год."},"metrics":{"type":"object","description":"Показатели формы отчётности: код строки → сумма, ₽. Например `2110` — выручка, `2400` — чистая прибыль, `1600` — активы.","additionalProperties":{"type":"number","format":"decimal"}}},"required":["year","metrics"]},"PartyAuthority":{"type":"object","properties":{"type":{"type":["string","null"],"description":"Вид органа. Не заполняется.","x-hintdata-filled":false},"code":{"type":["string","null"],"description":"Код органа."},"address":{"type":["string","null"],"description":"Адрес органа. Не заполняется.","x-hintdata-filled":false},"name":{"type":["string","null"],"description":"Наименование органа."}},"required":["type","code","address"]},"PartyDocument":{"type":"object","properties":{"type":{"type":"string","description":"Вид документа.\n\n- `FTS_REGISTRATION` — регистрация в налоговой;\n- `FTS_REPORT` — постановка на учёт в налоговой;\n- `PF_REGISTRATION` — регистрация в Социальном фонде (бывший ПФР);\n- `SIF_REGISTRATION` — регистрация в Социальном фонде (бывший ФСС).\n","enum":["FTS_REGISTRATION","FTS_REPORT","PF_REGISTRATION","SIF_REGISTRATION"]},"series":{"type":["string","null"],"description":"Серия. Не заполняется.","x-hintdata-filled":false},"number":{"type":["string","null"],"description":"Номер."},"issue_date":{"type":["string","null"],"description":"Дата. Дата в формате `ГГГГ-ММ-ДД`."},"issue_authority":{"type":["string","null"],"description":"Кто выдал. Не заполняется.","x-hintdata-filled":false}},"required":["type","series","number","issue_date","issue_authority"]},"AddressParts":{"type":"object","properties":{"region":{"type":"string","description":"Регион с типом, например «Московская обл»."},"city":{"type":"string","description":"Город."},"street":{"type":"string","description":"Улица."},"house":{"type":"string","description":"Дом с корпусом или строением, как пишется: «5 к 1»."},"area":{"type":"string","description":"Район."},"settlement":{"type":"string","description":"Населённый пункт."},"stead":{"type":"string","description":"Номер земельного участка."},"flat":{"type":"string","description":"Номер квартиры или помещения."},"territory":{"type":"string","description":"Территория: СНТ, ГСК, квартал."},"room":{"type":"string","description":"Номер комнаты."}},"required":["region"]},"AddressComponents":{"type":"object","properties":{"region":{"$ref":"#/components/schemas/AddressComponent","description":"Регион."},"city":{"$ref":"#/components/schemas/AddressComponent","description":"Город. У Москвы, Санкт-Петербурга и Севастополя — сам регион."},"city_area":{"$ref":"#/components/schemas/AddressComponent","description":"Административный округ Москвы."},"city_district":{"$ref":"#/components/schemas/AddressComponent","description":"Район города."},"street":{"$ref":"#/components/schemas/AddressComponent","description":"Улица."},"house":{"$ref":"#/components/schemas/AddressHouseComponent","description":"Дом."},"area":{"$ref":"#/components/schemas/AddressComponent","description":"Район."},"settlement":{"$ref":"#/components/schemas/AddressComponent","description":"Населённый пункт."},"stead":{"$ref":"#/components/schemas/AddressComponent","description":"Земельный участок."},"flat":{"$ref":"#/components/schemas/AddressComponent","description":"Квартира, помещение или машино-место."},"territory":{"$ref":"#/components/schemas/AddressComponent","description":"Территория: СНТ, ГСК, квартал."},"room":{"$ref":"#/components/schemas/AddressComponent","description":"Комната."}},"required":["region"]},"AddressComponent":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Название без типа."},"type":{"type":["string","null"],"description":"Тип уровня сокращённо: «обл», «г», «ул»."},"fias_id":{"type":["string","null"],"description":"Код ФИАС (UUID). Есть не у всех уровней: например, у округа и района города его нет."},"kladr_id":{"type":["string","null"],"description":"Код КЛАДР. У квартир, комнат, участков, округов и районов города его нет."}},"required":["name","type","fias_id","kladr_id"]},"AddressHouseComponent":{"type":"object","properties":{"name":{"type":"string","description":"Номер дома без типа и корпуса."},"type":{"type":["string","null"],"description":"Тип дома сокращённо: «д», «зд», «влд»."},"block":{"type":["string","null"],"description":"Корпус или строение, например «к 1»."},"fias_id":{"type":["string","null"],"description":"Код ФИАС дома (UUID)."},"kladr_id":{"type":["string","null"],"description":"Код КЛАДР дома."},"flat_count":{"type":["integer","null"],"description":"Число квартир в доме. Зависит от тарифа.","x-hintdata-plan":"address_premium"}},"required":["name","type","block","fias_id","kladr_id"]},"AddressCodes":{"type":"object","properties":{"postal":{"type":"string","description":"Почтовый индекс."},"kladr":{"type":"string","description":"Код КЛАДР адреса."},"region_kladr":{"type":"string","description":"Код КЛАДР региона."},"region_iso":{"type":"string","description":"Код региона по ISO 3166-2, например `RU-MOW`."},"okato":{"type":"string","description":"Код ОКАТО."},"oktmo":{"type":"string","description":"Код ОКТМО."},"tax_office":{"type":"string","description":"Код ИФНС для физических лиц."},"tax_office_legal":{"type":"string","description":"Код ИФНС для юридических лиц."},"fias_code":{"type":"string","description":"Код адреса по ФИАС из цифр."}},"required":["region_kladr","tax_office","tax_office_legal"]},"AddressGeo":{"type":"object","properties":{"lat":{"type":"number","description":"Широта."},"lon":{"type":"number","description":"Долгота."},"precision":{"type":["string","null"],"description":"Точность координат.\n\n- `exact` — точно по дому;\n- `cadastre` — по кадастровому объекту;\n- `nearest` — по соседнему дому той же улицы;\n- `street` — по улице;\n- `quarter` — по кадастровому кварталу;\n- `settlement` — по населённому пункту;\n- `city` — по городу;\n- `district` — по району.\n","enum":["exact","cadastre","nearest","street","quarter","settlement","city","district",null]}},"required":["lat","lon","precision"]},"AddressMatch":{"type":"object","properties":{"region":{"type":"string","description":"Регион.\n\n- `exact` — совпало с запросом;\n- `substituted` — в запросе было другое значение, подставлено ближайшее.\n","enum":["exact","substituted"]},"block":{"type":"string","description":"Корпус или строение.\n\n- `exact` — совпало с запросом;\n- `substituted` — в запросе было другое значение, подставлено ближайшее.\n","enum":["exact","substituted"]},"city":{"type":"string","description":"Город.\n\n- `exact` — совпало с запросом;\n- `substituted` — в запросе было другое значение, подставлено ближайшее.\n","enum":["exact","substituted"]},"flat":{"type":"string","description":"Квартира.\n\n- `exact` — совпало с запросом;\n- `substituted` — в запросе было другое значение, подставлено ближайшее.\n","enum":["exact","substituted"]},"house":{"type":"string","description":"Дом.\n\n- `exact` — совпало с запросом;\n- `substituted` — в запросе было другое значение, подставлено ближайшее.\n","enum":["exact","substituted"]},"litera":{"type":"string","description":"Литера.\n\n- `exact` — совпало с запросом;\n- `substituted` — в запросе было другое значение, подставлено ближайшее.\n","enum":["exact","substituted"]},"street":{"type":"string","description":"Улица.\n\n- `exact` — совпало с запросом;\n- `substituted` — в запросе было другое значение, подставлено ближайшее.\n","enum":["exact","substituted"]}}},"MetroStation":{"type":"object","properties":{"name":{"type":"string","description":"Станция."},"line":{"type":"string","description":"Линия."},"distance":{"type":"number","description":"Расстояние до станции, км."}},"required":["name","line","distance"]},"CadastreProfile":{"type":"object","properties":{"type":{"type":"string","description":"Вид объекта: «Здание», «Помещение», «Земельный участок»."},"area":{"type":"number","description":"Площадь, м²."},"year_built":{"type":"integer","description":"Год постройки."},"year_built_source":{"type":"string","description":"Откуда взят год постройки.\n\n- `built` — год постройки по ЕГРН;\n- `commissioned` — года постройки нет, взят год ввода в эксплуатацию.\n","enum":["built","commissioned"]},"year_commissioned":{"type":"integer","description":"Год ввода в эксплуатацию."},"floors":{"type":"integer","description":"Этажность."},"underground_floors":{"type":"integer","description":"Число подземных этажей."},"wall_material":{"type":"string","description":"Материал стен."},"registered_at":{"type":"string","description":"Дата постановки на кадастровый учёт."},"object_name":{"type":"string","description":"Наименование объекта в ЕГРН."},"cancelled_at":{"type":"string","description":"Дата снятия с кадастрового учёта."},"floor_number":{"type":"integer","description":"Этаж помещения."}}},"UnauthorizedError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["unauthorized"],"description":"`unauthorized` — ключ не передан или не найден."}}},"ForbiddenError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["disabled","forbidden_scope","forbidden_ip","forbidden_origin"],"description":"- `disabled` — ключ отключён;\n- `forbidden_scope` — у ключа нет права на этот метод;\n- `forbidden_ip` — запрос пришёл не с разрешённого для ключа IP;\n- `forbidden_origin` — сайт, с которого пришёл запрос, не разрешён для ключа.\n"}}},"TooManyRequestsError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["rate_limited","quota_exceeded"],"description":"- `rate_limited` — превышен лимит запросов в секунду;\n- `quota_exceeded` — исчерпан суточный лимит запросов; он обновляется в полночь UTC.\n"}}},"BadGatewayError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["upstream_error"],"description":"`upstream_error` — узел обработки не ответил. Запрос можно повторить."}}},"ServiceUnavailableError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["no_capacity","service_unavailable","quota_pending"],"description":"- `no_capacity` — нет доступного узла обработки;\n- `service_unavailable` — временный сбой. Запрос можно повторить.\n- `quota_pending` — выделенный суточный бюджет временно недоступен; повторите запрос через 1 секунду (`Retry-After: 1`).\n"}}},"PhoneFindRequest":{"type":"object","description":"Один номер в query или до 1000 строк в items. Если переданы оба поля, используется items. Пакет расходует дневной лимит по числу номеров.","properties":{"query":{"type":"string","description":"Один номер телефона. Нераспознанная строка возвращает пустой suggestions."},"items":{"type":"array","maxItems":1000,"items":{"type":"string"},"description":"Пакет номеров. Ответ results сохраняет порядок и число входных строк; нераспознанный номер возвращает карточку с qc и пустыми полями."},"mask":{"type":"string","description":"Формат вывода номера: e164, intl, national, intl_sp, dash, spaces, plain, plain8 или свой шаблон из 10 плейсхолдеров (#, X, x, 9, 0, N, n). Код страны и префикс задаются литералами. Например: +7 (XXX) XXX-XX-XX. Без маски — стандартный формат."},"omit_null":{"$ref":"#/components/schemas/OmitNull"}},"anyOf":[{"required":["query"]},{"required":["items"]}]},"PhoneRecord":{"type":"object","description":"Карточка номера. Тип и регион доступны любому тарифу; поля оператора и переноса отсутствуют без phone_mnp. Null означает отсутствие данных, а не отсутствие права.","properties":{"source":{"type":"string","description":"Номер из запроса."},"phone":{"type":["string","null"],"description":"Номер в стандартном виде."},"type":{"type":["string","null"],"description":"Тип номера."},"is_valid":{"type":"boolean","description":"Номер существует в плане нумерации."},"country_code":{"type":["string","null"],"description":"Код страны."},"city_code":{"type":["string","null"],"description":"Код города или оператора."},"number":{"type":["string","null"],"description":"Абонентский номер."},"extension":{"type":["string","null"],"description":"Добавочный."},"operator":{"type":["string","null"],"description":"Текущий оператор. Поле отсутствует без гранта phone_mnp (тарифы «Бизнес» и «Корпоративный»); null — данные не определены.","x-hintdata-plan":"phone_mnp"},"operator_inn":{"type":["string","null"],"description":"ИНН текущего оператора. Поле отсутствует без гранта phone_mnp (тарифы «Бизнес» и «Корпоративный»); null — данные не определены. ИНН оператора передаётся строкой.","x-hintdata-plan":"phone_mnp"},"operator_original":{"type":["string","null"],"description":"Оператор до переноса. Поле отсутствует без гранта phone_mnp (тарифы «Бизнес» и «Корпоративный»); null — данные не определены.","x-hintdata-plan":"phone_mnp"},"ported":{"type":["boolean","null"],"description":"Номер перенесён. Поле отсутствует без гранта phone_mnp (тарифы «Бизнес» и «Корпоративный»); null — данные не определены.","x-hintdata-plan":"phone_mnp"},"mcc":{"type":["string","null"],"description":"Код страны сети (MCC). Поле отсутствует без гранта phone_mnp (тарифы «Бизнес» и «Корпоративный»); null — данные не определены. Код страны сети E.212, строка с сохранением ведущих нулей.","x-hintdata-plan":"phone_mnp"},"mnc":{"type":["string","null"],"description":"Код сети (MNC). Поле отсутствует без гранта phone_mnp (тарифы «Бизнес» и «Корпоративный»); null — данные не определены. Код мобильной сети E.212, строка с сохранением ведущих нулей.","x-hintdata-plan":"phone_mnp"},"country":{"type":["string","null"],"description":"Страна."},"region":{"type":["string","null"],"description":"Регион выдачи номера."},"city":{"type":["string","null"],"description":"Город (у стационарных)."},"timezone":{"type":["string","null"],"description":"Часовой пояс."},"qc":{"type":"integer","description":"Код качества разбора."},"qc_conflict":{"type":"integer","description":"Конфликт с адресом (как у DaData)."}},"required":["source","phone","type","is_valid","country_code","city_code","number","extension","country","region","city","timezone","qc","qc_conflict"]},"PhoneFindResponse":{"oneOf":[{"type":"object","required":["query","suggestions"],"properties":{"query":{"type":"string"},"suggestions":{"type":"array","maxItems":1,"items":{"$ref":"#/components/schemas/PhoneRecord"}}}},{"type":"object","required":["results"],"properties":{"results":{"type":"array","maxItems":1000,"items":{"$ref":"#/components/schemas/PhoneRecord"}}}}]},"Account":{"type":"object","additionalProperties":false,"required":["limits","balance"],"properties":{"limits":{"$ref":"#/components/schemas/AccountLimits"},"balance":{"type":"number","format":"decimal","description":"Баланс в рублях."}}},"AccountLimits":{"type":"object","additionalProperties":false,"required":["rps","daily"],"properties":{"rps":{"type":["integer","null"],"format":"int32","minimum":1,"description":"Максимальное число запросов в секунду для ключа. null — без ограничения."},"daily":{"type":"object","additionalProperties":{"type":"integer","format":"int32","minimum":1},"description":"Суточные лимиты запросов по группам методов, а не остатки. Группы без дневного ограничения не возвращаются."}}},"AccountUnauthorizedError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["unauthorized"]}}},"AccountForbiddenError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["disabled","forbidden_key_type","forbidden_ip","forbidden_origin"]}}},"AccountBillingUnavailableError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["billing_unavailable"]}}}},"headers":{"RetryAfter":{"description":"Через сколько секунд повторить запрос.","schema":{"type":"integer"}}},"responses":{"AddressSuggestOk":{"description":"Подсказки адреса.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressSuggestResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"query":"москва центральная 9","suggestions":[{"value":"г Москва, ул Центральная, д 9","full":"125430, г Москва, ул Центральная, д 9","level":"house","is_active":true,"confidence":0.9761,"federal_district":"Центральный","address":{"region":"Москва г","city":"Москва","street":"Центральная","house":"9"},"components":{"region":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"city":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"city_area":{"name":"Северо-западный","type":"округ","fias_id":null,"kladr_id":null},"city_district":{"name":"Митино","type":"р-н","fias_id":null,"kladr_id":null},"street":{"name":"Центральная","type":"ул","fias_id":"87f8778c-494d-4cb4-8009-4ccc8c7884b1","kladr_id":"77000000000306500"},"house":{"name":"9","type":"д","block":null,"fias_id":"4fdc5e81-8dfa-4916-9f7b-c98f0fe2e54a","kladr_id":"7700000000030650006","flat_count":84}},"codes":{"postal":"125430","kladr":"7700000000030650006","region_kladr":"7700000000000","region_iso":"RU-MOW","okato":"45283559000","oktmo":"45367000","tax_office":"7700","tax_office_legal":"7700"},"fias_id":"4fdc5e81-8dfa-4916-9f7b-c98f0fe2e54a","fias_level":8,"geo":{"lat":55.85313,"lon":37.385381,"precision":"exact"},"timezone":"UTC+3","metro":[{"name":"Митино","line":"Арбатско-Покровская","distance":1.69},{"name":"Волоколамская","line":"Арбатско-Покровская","distance":1.99}],"beltway_hit":"OUT_MKAD","beltway_distance":1,"cadastral_num":"77:08:0002016:1089","cadastre":{"type":"Здание","area":3755.6,"year_built":1970,"year_built_source":"built","year_commissioned":1970,"floors":5,"underground_floors":1,"wall_material":"Железобетон","registered_at":"2012-05-23"},"cadastral_cost":704132974.84,"cadastral_cost_per_unit":187488.81},{"value":"г Москва, Краснопахорский р-н, д Шарапово, ул Центральная, д 9","full":"108828, г Москва, Краснопахорский р-н, д Шарапово, ул Центральная, д 9","level":"house","is_active":true,"confidence":0.8661,"federal_district":"Центральный","address":{"region":"Москва г","area":"Краснопахорский","city":"Москва","settlement":"Шарапово","street":"Центральная","house":"9"},"components":{"region":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"area":{"name":"Краснопахорский","type":"р-н","fias_id":"57ef56d5-78cb-4c78-8d2a-3d28c982bffa","kladr_id":"7702200000000"},"city":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"city_area":{"name":"Троицкий","type":"округ","fias_id":null,"kladr_id":null},"city_district":{"name":"Краснопахорский","type":"р-н","fias_id":null,"kladr_id":null},"settlement":{"name":"Шарапово","type":"д","fias_id":"9ac7988a-550a-4981-8271-ffcc37745feb","kladr_id":"7702200001200"},"street":{"name":"Центральная","type":"ул","fias_id":"e8dcb160-d144-4d78-b1d9-8cfdefb43047","kladr_id":"77022000012000600"},"house":{"name":"9","type":"д","block":null,"fias_id":"60db8d39-fbd9-4249-b366-31976b0e4348","kladr_id":"7702200001200060145","flat_count":null}},"codes":{"postal":"108828","kladr":"7702200001200060145","region_kladr":"7700000000000","region_iso":"RU-MOW","okato":"45298561000","oktmo":"45948000","tax_office":"7751","tax_office_legal":"7751"},"fias_id":"60db8d39-fbd9-4249-b366-31976b0e4348","fias_level":8,"geo":{"lat":55.85313,"lon":37.385381,"precision":"exact"},"timezone":"UTC+3","metro":[{"name":"Митино","line":"Арбатско-Покровская","distance":1.69},{"name":"Волоколамская","line":"Арбатско-Покровская","distance":1.99}],"beltway_hit":"OUT_MKAD","beltway_distance":1,"cadastral_num":"77:22:0000000:56","cadastre":{"type":"Здание","object_name":"объект индивидуального жилищного строительства","area":194.8,"year_built":2012,"year_built_source":"built","floors":2,"wall_material":"Деревянные","registered_at":"2013-03-22"},"cadastral_cost":4519595.71,"cadastral_cost_per_unit":23201.21}]}},"sparse":{"summary":"Ответ с минимумом полей","value":{"query":"121087, Г.МОСКВА, ВН.ТЕР.Г. МУНИЦИПАЛЬНЫЙ ОКРУГ ФИЛЕВСКИЙ ПАРК, УЛ БОЛЬШАЯ ФИЛЁВСКАЯ, Д. 4, ЭТАЖ/ПОМЕЩ. 1/30А, ОФИС А6","suggestions":[{"value":"г Москва, вн.тер.г муниципальный округ Филевский парк","full":"г Москва, вн.тер.г муниципальный округ Филевский парк","level":"area","is_active":true,"match":{"region":"exact"},"federal_district":"Центральный","address":{"region":"Москва г","area":"муниципальный округ Филевский парк","city":"Москва"},"components":{"region":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"area":{"name":"муниципальный округ Филевский парк","type":"вн.тер.г","fias_id":"d0637609-de65-4162-b86a-fe2150ae4e83","kladr_id":null},"city":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"}},"codes":{"region_kladr":"7700000000000","region_iso":"RU-MOW","oktmo":"45328000","tax_office":"7700","tax_office_legal":"7700"},"fias_id":"d0637609-de65-4162-b86a-fe2150ae4e83","fias_level":3,"geo":{"lat":55.75204,"lon":37.61781,"precision":"city"},"timezone":"UTC+3"}]}}}}}},"AddressFindByIdOk":{"description":"Адрес по коду.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressFindByIdResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"query":"3947769a-486b-424f-819a-147d1ce641be","suggestions":[{"value":"г Москва, р-н Внуково, п Толстопальцево, ул Пушкина, д 50","full":"108809, г Москва, р-н Внуково, п Толстопальцево, ул Пушкина, д 50","level":"house","is_active":true,"federal_district":"Центральный","address":{"region":"Москва г","area":"Внуково","city":"Москва","settlement":"Толстопальцево","street":"Пушкина","house":"50"},"components":{"region":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"area":{"name":"Внуково","type":"р-н","fias_id":"3d0d421e-3a94-4524-ad2d-6a6a10a1fab4","kladr_id":"7702400000000"},"city":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"city_area":{"name":"Новомосковский","type":"округ","fias_id":null,"kladr_id":null},"city_district":{"name":"Внуково","type":"р-н","fias_id":null,"kladr_id":null},"settlement":{"name":"Толстопальцево","type":"п","fias_id":"9e967ebb-9993-433f-94d7-e29ab823f359","kladr_id":"7702400003000"},"street":{"name":"Пушкина","type":"ул","fias_id":"284416a5-98e8-4b91-ac0f-3efd2d994939","kladr_id":"77024000030420100"},"house":{"name":"50","type":"д","block":null,"fias_id":"3947769a-486b-424f-819a-147d1ce641be","kladr_id":"7702400003042010058","flat_count":1}},"codes":{"postal":"108809","kladr":"7702400003042010058","region_kladr":"7700000000000","region_iso":"RU-MOW","okato":"45297552000","oktmo":"45941000","tax_office":"7729","tax_office_legal":"7729"},"fias_id":"3947769a-486b-424f-819a-147d1ce641be","fias_level":8,"geo":{"lat":55.603848,"lon":37.215655,"precision":"exact"},"timezone":"UTC+3","metro":[{"name":"Толстопальцево","line":"МЦД-4","distance":1.92},{"name":"Кокошкино","line":"МЦД-4","distance":2.83}],"beltway_hit":"OUT_MKAD","beltway_distance":16,"cadastral_num":"77:07:0017002:3415","cadastre":{"type":"Здание","object_name":"ЖИЛОЙ ДОМ","area":129.6,"year_built":1964,"year_built_source":"built","year_commissioned":1964,"floors":1,"wall_material":"Панельные","registered_at":"2014-06-18"},"cadastral_cost":2155809.17,"cadastral_cost_per_unit":16634.33}]}},"sparse":{"summary":"Ответ с минимумом полей","value":{"query":"04d0b9ba-aeb1-40f9-ab79-7d3d4cae7e10","suggestions":[{"value":"Алтайский край, м.р-н Немецкий национальный, с.п Редкодубравский сельсовет","full":"Алтайский край, м.р-н Немецкий национальный, с.п Редкодубравский сельсовет","level":"settlement","is_active":false,"federal_district":"Сибирский","address":{"region":"Алтайский край","area":"Немецкий национальный","settlement":"Редкодубравский сельсовет"},"components":{"region":{"name":"Алтайский","type":"край","fias_id":"8276c6a1-1a86-4f0d-8920-aba34d4cc34a","kladr_id":"2200000000000"},"area":{"name":"Немецкий национальный","type":"м.р-н","fias_id":"2ffefb57-ca12-44b2-ab55-535449e3876f","kladr_id":null},"settlement":{"name":"Редкодубравский сельсовет","type":"с.п","fias_id":"04d0b9ba-aeb1-40f9-ab79-7d3d4cae7e10","kladr_id":null}},"codes":{"region_kladr":"2200000000000","region_iso":"RU-ALT","oktmo":"01660450","tax_office":"2200","tax_office_legal":"2200"},"fias_id":"04d0b9ba-aeb1-40f9-ab79-7d3d4cae7e10","fias_level":6,"timezone":"UTC+7"}]}}}}}},"AddressGeolocateOk":{"description":"Ближайшие адреса.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressGeolocateResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"query":"","suggestions":[{"value":"Респ Северная Осетия - Алания, Пригородный р-н, с Ногир, ул Ворошилова, двлд 43","full":"363121, Респ Северная Осетия - Алания, Пригородный р-н, с Ногир, ул Ворошилова, двлд 43","level":"house","is_active":true,"federal_district":"Северо-Кавказский","address":{"region":"Северная Осетия - Алания респ","area":"Пригородный","settlement":"Ногир","street":"Ворошилова","house":"43"},"components":{"region":{"name":"Северная Осетия - Алания","type":"респ","fias_id":"de459e9c-2933-4923-83d1-9c64cfd7a817","kladr_id":"1500000000000"},"area":{"name":"Пригородный","type":"р-н","fias_id":"5f2f61c4-d613-49e0-b1b0-2d5c454043f0","kladr_id":"1500900000000"},"settlement":{"name":"Ногир","type":"с","fias_id":"1292731b-a715-4d19-8788-c4eaac028e90","kladr_id":"1500900001400"},"street":{"name":"Ворошилова","type":"ул","fias_id":"46a37358-74e0-4632-b0ee-a3413bfd25e6","kladr_id":"15009000014000300"},"house":{"name":"43","type":"двлд","block":null,"fias_id":"3c8be501-7793-41fe-b7fd-294046fbfe94","kladr_id":"1500900001400030042","flat_count":null}},"codes":{"postal":"363121","kladr":"1500900001400030042","region_kladr":"1500000000000","region_iso":"RU-SE","okato":"90240855001","oktmo":"90640455101","tax_office":"1500","tax_office_legal":"1500"},"fias_id":"3c8be501-7793-41fe-b7fd-294046fbfe94","fias_level":8,"geo":{"lat":43.074735,"lon":44.644402,"precision":"cadastre"},"timezone":"UTC+3","cadastral_num":"15:08:0210161:60","cadastre":{"type":"Здание","object_name":"Жилой дом (лит АА1)","area":91.3,"year_built":2008,"year_built_source":"commissioned","year_commissioned":2008,"floors":1,"underground_floors":1,"wall_material":"Из прочих материалов","registered_at":"2013-10-26"},"cadastral_cost":815602.99,"cadastral_cost_per_unit":8933.22},{"value":"Респ Северная Осетия - Алания, Пригородный р-н, с Ногир, ул Ворошилова, двлд 47","full":"363121, Респ Северная Осетия - Алания, Пригородный р-н, с Ногир, ул Ворошилова, двлд 47","level":"house","is_active":true,"federal_district":"Северо-Кавказский","address":{"region":"Северная Осетия - Алания респ","area":"Пригородный","settlement":"Ногир","street":"Ворошилова","house":"47"},"components":{"region":{"name":"Северная Осетия - Алания","type":"респ","fias_id":"de459e9c-2933-4923-83d1-9c64cfd7a817","kladr_id":"1500000000000"},"area":{"name":"Пригородный","type":"р-н","fias_id":"5f2f61c4-d613-49e0-b1b0-2d5c454043f0","kladr_id":"1500900000000"},"settlement":{"name":"Ногир","type":"с","fias_id":"1292731b-a715-4d19-8788-c4eaac028e90","kladr_id":"1500900001400"},"street":{"name":"Ворошилова","type":"ул","fias_id":"46a37358-74e0-4632-b0ee-a3413bfd25e6","kladr_id":"15009000014000300"},"house":{"name":"47","type":"двлд","block":null,"fias_id":"08f3ac94-dd33-495c-b284-5302cd091dd7","kladr_id":"1500900001400030046","flat_count":null}},"codes":{"postal":"363121","kladr":"1500900001400030046","region_kladr":"1500000000000","region_iso":"RU-SE","okato":"90240855001","oktmo":"90640455101","tax_office":"1500","tax_office_legal":"1500"},"fias_id":"08f3ac94-dd33-495c-b284-5302cd091dd7","fias_level":8,"geo":{"lat":43.074573,"lon":44.644056,"precision":"cadastre"},"timezone":"UTC+3","cadastral_num":"15:08:0210161:40","cadastre":{"type":"Здание","object_name":"Жилой дом литер \"А\"","area":137,"year_built":1900,"year_built_source":"built","year_commissioned":1900,"floors":1,"underground_floors":0,"wall_material":"Кирпичные","registered_at":"2012-06-27"},"cadastral_cost":1223851.14,"cadastral_cost_per_unit":8933.22}]}},"sparse":{"summary":"Ответ с минимумом полей","value":{"query":"","suggestions":[{"value":"Курская обл, Касторенский р-н, д Знамя-Колтовская, ул Колтовская, уч 80","full":"306700, Курская обл, Касторенский р-н, д Знамя-Колтовская, ул Колтовская, уч 80","level":"stead","is_active":true,"federal_district":"Центральный","address":{"region":"Курская обл","area":"Касторенский","settlement":"Знамя-Колтовская","street":"Колтовская","stead":"80"},"components":{"region":{"name":"Курская","type":"обл","fias_id":"ee594d5e-30a9-40dc-b9f2-0add1be44ba1","kladr_id":"4600000000000"},"area":{"name":"Касторенский","type":"р-н","fias_id":"51294c9c-4f55-4b9d-a64f-68310237b4f4","kladr_id":"4600900000000"},"settlement":{"name":"Знамя-Колтовская","type":"д","fias_id":"e0cbc65f-0b08-45c4-ad31-d6f968d1b360","kladr_id":"4600900003800"},"street":{"name":"Колтовская","type":"ул","fias_id":"f0491365-e7c1-489d-bb0a-a8d209833c0a","kladr_id":"46009000038000100"},"stead":{"name":"80","type":"уч","fias_id":"1e9661c4-1202-4454-89bd-67200ca86c25","kladr_id":null}},"codes":{"postal":"306700","kladr":"46009000038000100","region_kladr":"4600000000000","region_iso":"RU-KRS","okato":"38214852002","oktmo":"38614452106","tax_office":"4600","tax_office_legal":"4600"},"fias_id":"1e9661c4-1202-4454-89bd-67200ca86c25","fias_level":75,"geo":{"lat":51.83278,"lon":38.10476,"precision":"cadastre"},"timezone":"UTC+3","cadastral_num":"46:08:110302:68","cadastre":{"type":"Земельный участок","object_name":"01","area":1500,"registered_at":"2006-01-01"},"cadastral_cost":173350.55,"cadastral_cost_per_unit":115.567}]}}}}}},"AddressIplocateOk":{"description":"Город по IP.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressIplocateResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"location":{"value":"г Санкт-Петербург, ул сдт Учитель Центральная","full":"г Санкт-Петербург, ул сдт Учитель Центральная","level":"street","is_active":true,"confidence":0.004,"federal_district":"Северо-Западный","address":{"region":"Санкт-Петербург г","city":"Санкт-Петербург","street":"сдт Учитель Центральная"},"components":{"region":{"name":"Санкт-Петербург","type":"г","fias_id":"c2deb16a-0330-4f05-821f-1d09c93331e6","kladr_id":"7800000000000"},"city":{"name":"Санкт-Петербург","type":"г","fias_id":"c2deb16a-0330-4f05-821f-1d09c93331e6","kladr_id":"7800000000000"},"city_district":{"name":"Приморский","type":"р-н","fias_id":null,"kladr_id":null},"street":{"name":"сдт Учитель Центральная","type":"ул","fias_id":"4349bcd9-ed73-438f-ba6a-678a97619a29","kladr_id":"78000000000249900"}},"codes":{"kladr":"78000000000249900","region_kladr":"7800000000000","region_iso":"RU-SPE","fias_code":"7800000000000002499","okato":"40270561000","oktmo":"40321000","tax_office":"7814","tax_office_legal":"7814"},"fias_id":"4349bcd9-ed73-438f-ba6a-678a97619a29","fias_level":7,"geo":{"lat":59.923655,"lon":30.299375,"precision":"district"},"timezone":"UTC+3"},"network":{"asn":15378,"operator":"TELE2-RU-AS","type":"isp","is_hosting":false}}},"sparse":{"summary":"Ответ с минимумом полей","value":{"location":{"value":"г Москва","full":"г Москва","level":"region","is_active":true,"confidence":0.9492,"federal_district":"Центральный","address":{"region":"Москва г","city":"Москва"},"components":{"region":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"city":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"}},"codes":{"kladr":"7700000000000","region_kladr":"7700000000000","region_iso":"RU-MOW","fias_code":"7700000000000000000","okato":"45000000000","oktmo":"45000000","tax_office":"7700","tax_office_legal":"7700"},"fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","fias_level":1,"geo":{"lat":55.75204,"lon":37.61781,"precision":"city"},"timezone":"UTC+3"},"network":{"asn":13238,"operator":"YANDEX","type":"isp","is_hosting":false}}},"not_found":{"summary":"Город не определён","value":{"location":null,"network":{"asn":13238,"operator":"YANDEX","type":"isp","is_hosting":false}}}}}}},"PartySuggestOk":{"description":"Подсказки организаций.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartySuggestResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"query":"ООО \"НОРФОЛД\"","suggestions":[{"value":"ООО \"НОРФОЛД\"","inn":"7733464260","ogrn":"1257700078811","kpp":"773301001","type":"LEGAL","name":{"full":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"НОРФОЛД\"","short":"ООО \"НОРФОЛД\"","latin":null,"clean":"НОРФОЛД"},"opf":{"code":"12300","short":"ООО","full":"Общество с ограниченной ответственностью","type":"2014"},"okveds":[{"code":"41.10","name":"Разработка строительных проектов","main":true,"type":"2014"}],"address":{"value":"125371, Г.МОСКВА, ВН.ТЕР.Г. МУНИЦИПАЛЬНЫЙ ОКРУГ ПОКРОВСКОЕ-СТРЕШНЕВО, Ш. ВОЛОКОЛАМСКОЕ, Д. 114, К. 1, ПОМЕЩ. 2/1","postal_code":"125371","fias_id":"fca13bfd-5ec2-4a74-a785-e1cd1a9352c5","region":"77","region_name":"Москва г","city":null},"state":{"status":"ACTIVE","code":null,"name":null,"exclusion_decision":null,"egrul_changed_at":null,"actuality_date":"2026-05-18","registration_date":"2025-02-20","liquidation_date":null},"ogrn_date":"2025-02-20","invalid":{"code":"2","name":"сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)","date":"2026-05-18"},"codes":{"okpo":"83907625","okato":"45283569000","oktmo":"45368000000","okogu":"4210014","okfs":"16"},"kpp_largest":null,"branch_type":"MAIN","branch_count":0,"management":{"name":"ВОРОТНИКОВ ДЕНИС ВЛАДИМИРОВИЧ","post":"ГЕНЕРАЛЬНЫЙ ДИРЕКТОР","post_type":"Руководитель юридического лица","start_date":"2025-08-13","disqualified":null}}]}},"sparse":{"summary":"Ответ с минимумом полей","value":{"query":"ПРЕДСТАВИТЕЛЬСТВО НЕКОММЕРЧЕСКОЙ КОРПОРАЦИИ ХИАС, ИНК. (США) В РОССИЙСКОЙ ФЕДЕРАЦИИ","suggestions":[{"value":"ПРЕДСТАВИТЕЛЬСТВО НЕКОММЕРЧЕСКОЙ КОРПОРАЦИИ ХИАС, ИНК. (США) В РОССИЙСКОЙ ФЕДЕРАЦИИ","inn":"9909037854","ogrn":"9909037854","kpp":null,"type":"LEGAL","name":{"full":"ПРЕДСТАВИТЕЛЬСТВО НЕКОММЕРЧЕСКОЙ КОРПОРАЦИИ ХИАС, ИНК. (США) В РОССИЙСКОЙ ФЕДЕРАЦИИ","short":"ПРЕДСТАВИТЕЛЬСТВО НЕКОММЕРЧЕСКОЙ КОРПОРАЦИИ ХИАС, ИНК. (США) В РОССИЙСКОЙ ФЕДЕРАЦИИ","latin":null,"clean":"ПРЕДСТАВИТЕЛЬСТВО НЕКОММЕРЧЕСКОЙ КОРПОРАЦИИ ХИАС, ИНК. (США) В РОССИЙСКОЙ ФЕДЕРАЦИИ"},"opf":{"code":"30001","short":"Представительство","full":"Представительство юридического лица","type":"2014"},"okveds":[{"code":"73.11","name":"Деятельность рекламных агентств","main":true,"type":"2014"}],"address":{"value":null,"postal_code":null,"fias_id":null,"region":null,"region_name":null,"city":null},"state":{"status":"ACTIVE","code":null,"name":null,"exclusion_decision":null,"egrul_changed_at":null,"actuality_date":"2020-03-17","registration_date":null,"liquidation_date":null},"ogrn_date":null,"invalid":null,"codes":{"okpo":"57085708","okato":null,"oktmo":null,"okogu":null,"okfs":null},"kpp_largest":null,"branch_type":"MAIN","branch_count":0,"management":null}]}}}}}},"PartyFindByIdOk":{"description":"Записи под ИНН или ОГРН.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyFindByIdResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"query":"5008043485","suggestions":[{"value":"ТСН \"ТСЖ МОЛОДЕЖНАЯ-14\"","inn":"5008043485","ogrn":"1075000002868","kpp":"500801001","type":"LEGAL","name":{"full":"ТОВАРИЩЕСТВО СОБСТВЕННИКОВ НЕДВИЖИМОСТИ \"ТОВАРИЩЕСТВО СОБСТВЕННИКОВ ЖИЛЬЯ МОЛОДЕЖНАЯ-14\"","short":"ТСН \"ТСЖ МОЛОДЕЖНАЯ-14\"","latin":null,"clean":"ТСН ТСЖ МОЛОДЕЖНАЯ-14"},"opf":{"code":"20700","short":"ТСН","full":"Товарищество собственников недвижимости","type":"2014"},"okveds":[{"code":"68.32","name":"Управление недвижимым имуществом за вознаграждение или на договорной основе","main":true,"type":"2014"},{"code":"68.1","name":"Покупка и продажа собственного недвижимого имущества","main":false,"type":"2014"}],"address":{"value":"г Долгопрудный, ул Молодежная, д 14, кв 28","full":"141707, Московская обл, г Долгопрудный, ул Молодежная, д 14, кв 28","level":"flat","is_active":true,"confidence":0.8128,"federal_district":"Центральный","address":{"region":"Московская обл","city":"Долгопрудный","street":"Молодежная","house":"14","flat":"28"},"components":{"region":{"name":"Московская","type":"обл","fias_id":"29251dcf-00a1-4e34-98d4-5c47484a36d4","kladr_id":"5000000000000"},"city":{"name":"Долгопрудный","type":"г","fias_id":"dcf522ad-e032-4db9-9dbb-e30d2cddfadb","kladr_id":"5000002900000"},"street":{"name":"Молодежная","type":"ул","fias_id":"dcded1fb-5778-4873-90e0-a8a7e0de8b89","kladr_id":"50000029000001700"},"house":{"name":"14","type":"д","block":null,"fias_id":"43a031c2-98dc-4237-a339-536320c678f1","kladr_id":"5000002900000170012","flat_count":null},"flat":{"name":"28","type":"кв","fias_id":"09cb956b-ee7f-4660-ab0a-dd746e4dd060","kladr_id":null}},"codes":{"postal":"141707","kladr":"5000002900000170012","region_kladr":"5000000000000","region_iso":"RU-MOS","okato":"46416000000","oktmo":"46716000001","tax_office":"5047","tax_office_legal":"5047"},"fias_id":"09cb956b-ee7f-4660-ab0a-dd746e4dd060","fias_level":9,"geo":{"lat":55.942214,"lon":37.485768,"precision":"exact"},"capital_marker":"1","metro":[{"name":"Водники","line":"МЦД-1","distance":2.02},{"name":"Долгопрудная","line":"МЦД-1","distance":2.14}],"cadastral_num":"50:42:0020101:770","house_level":true},"state":{"status":"ACTIVE","code":null,"name":null,"exclusion_decision":null,"egrul_changed_at":"2025-01-29","actuality_date":"2025-01-29","registration_date":"2007-03-29","liquidation_date":null},"ogrn_date":"2007-03-29","invalid":null,"codes":{"okpo":"99170019","okato":"46416000000","oktmo":"46716000001","okogu":"4210014","okfs":"16"},"kpp_largest":null,"branch_type":"MAIN","branch_count":0,"management":{"name":"ДАБИЖА ДЕНИС АЛЕКСЕЕВИЧ","post":"ПРЕДСЕДАТЕЛЬ ПРАВЛЕНИЯ","post_type":"Руководитель юридического лица","start_date":"2023-06-19","disqualified":null},"capital":null,"revenue":107000,"smb":null,"employee_count":null,"founders":[{"kind":"PERSON","type":"PHYSICAL","ogrn":null,"inn":"500500076523","name":"СОРОКИНА ЕЛЕНА ВАСИЛЬЕВНА","fio":{"source":"СОРОКИНА ЕЛЕНА ВАСИЛЬЕВНА","result":"Сорокина Елена Васильевна","surname":"Сорокина","name":"Елена","patronymic":"Васильевна","gender":"Ж","qc":0},"start_date":null,"share":null,"country_code":null,"country_name":null,"foreign_reg_number":null,"invalidity":null},{"kind":"PERSON","type":"PHYSICAL","ogrn":null,"inn":null,"name":"АХУНОВА ДИАНА РЕНАТОВНА","fio":{"source":"АХУНОВА ДИАНА РЕНАТОВНА","result":"Ахунова Диана Ренатовна","surname":"Ахунова","name":"Диана","patronymic":"Ренатовна","gender":"Ж","qc":0},"start_date":null,"share":null,"country_code":null,"country_name":null,"foreign_reg_number":null,"invalidity":null}],"managers":[{"ogrn":null,"inn":"500800163400","name":"ДАБИЖА ДЕНИС АЛЕКСЕЕВИЧ","fio":{"source":"ДАБИЖА ДЕНИС АЛЕКСЕЕВИЧ","result":"Дабижа Денис Алексеевич","surname":"Дабижа","name":"Денис","patronymic":"Алексеевич","gender":"М","qc":0},"post":"ПРЕДСЕДАТЕЛЬ ПРАВЛЕНИЯ","post_type":"Руководитель юридического лица","type":"EMPLOYEE","start_date":"2023-06-19","citizenship_code":"1","invalidity":null}],"tax_regimes":null,"finance":[{"year":2025,"metrics":{"1200":20542000,"1230":3348000,"1250":17193000,"1300":18465000,"1330":16798000,"1500":2076000,"1520":2076000,"1600":20542000,"1700":20542000,"2100":107000,"2110":107000,"2200":107000,"2300":266000,"2320":83000,"2340":110000,"2350":-34000,"2400":230000,"2410":-36000,"2500":230000,"4100":4916000,"4110":16459000,"4111":94000,"4119":16365000,"4120":-11543000,"4121":-11012000,"4122":-131000,"4129":-330000,"412x":-70000,"4400":4916000,"4450":12278000,"4500":17194000}},{"year":2024,"metrics":{"1200":15586000,"1230":3308000,"1250":12278000,"1300":12672000,"1350":12672000,"1500":2914000,"1520":2914000,"1600":15586000,"1700":15586000,"2100":116000,"2110":116000,"2200":116000,"2300":244000,"2320":67000,"2340":92000,"2350":-31000,"2400":203000,"2410":-41000,"2411":-41000,"2500":203000,"3100":9501000,"3200":9501000,"3300":9501000,"3600":12672000,"4100":3426000,"4110":13790000,"4111":131000,"4119":13659000,"4120":-10364000,"4121":-9958000,"4122":-174000,"4129":-232000,"4400":3426000,"4450":8852000,"4500":12278000}}],"emails":[],"phones":null,"sites":null,"licenses":null,"authorities":{"fts_registration":{"type":null,"code":"5081","address":null,"name":"Межрайонная инспекция Федеральной налоговой службы №23 по Московской области"},"fts_report":{"type":null,"code":"5047","address":null,"name":"Межрайонная инспекция Федеральной налоговой службы №13 по Московской области"},"pf":{"type":null,"code":"050","address":null,"name":null},"sif":{"type":null,"code":"050","address":null,"name":null}},"documents":{"fts_registration":null,"fts_report":{"type":"FTS_REPORT","series":null,"number":null,"issue_date":"2007-03-29","issue_authority":null},"pf_registration":{"type":"PF_REGISTRATION","series":null,"number":"1037637525","issue_date":"2007-05-16","issue_authority":null},"sif_registration":{"type":"SIF_REGISTRATION","series":null,"number":"1037637525","issue_date":"2007-04-28","issue_authority":null},"smb":null},"predecessors":null,"successors":null}]}},"sparse":{"summary":"Ответ с минимумом полей","value":{"query":"9909222818","suggestions":[{"value":"ФИЛИАЛ КОМПАНИИ С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ ИНТЕРКАР ТРЕЙДИНГ ЛИМИТЕД","inn":"9909222818","ogrn":"10170000566","kpp":"774791001","type":"LEGAL","name":{"full":"ФИЛИАЛ КОМПАНИИ С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ ИНТЕРКАР ТРЕЙДИНГ ЛИМИТЕД","short":"ФИЛИАЛ КОМПАНИИ С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ ИНТЕРКАР ТРЕЙДИНГ ЛИМИТЕД","latin":null,"clean":"ФИЛИАЛ КОМПАНИИ С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ ИНТЕРКАР ТРЕЙДИНГ ЛИМИТЕД"},"opf":{"code":"30002","short":"Филиал","full":"Филиал юридического лица","type":"2014"},"okveds":[{"code":"68.20","name":"Аренда и управление собственным или арендованным недвижимым имуществом","main":true,"type":"2014"}],"address":{"value":null,"postal_code":null,"fias_id":null,"region":null,"region_name":null,"city":null},"state":{"status":"ACTIVE","code":null,"name":null,"exclusion_decision":null,"egrul_changed_at":null,"actuality_date":"2021-03-12","registration_date":"2017-05-11","liquidation_date":null},"ogrn_date":"2017-05-11","invalid":null,"codes":{"okpo":"28718667","okato":null,"oktmo":"45380000000","okogu":null,"okfs":"23"},"kpp_largest":null,"branch_type":"MAIN","branch_count":0,"management":{"name":"Семенова Татьяна Борисовна","post":null,"post_type":null,"start_date":"2021-03-13","disqualified":null},"capital":null,"revenue":null,"smb":null,"employee_count":null,"founders":null,"managers":[{"ogrn":null,"inn":null,"name":"Семенова Татьяна Борисовна","fio":null,"post":null,"post_type":null,"type":"EMPLOYEE","start_date":"2021-03-13","citizenship_code":null,"invalidity":null}],"tax_regimes":null,"finance":null,"emails":[],"phones":null,"sites":null,"licenses":null,"authorities":null,"documents":null,"predecessors":null,"successors":null}]}}}}}},"PartyFindAffiliatedOk":{"description":"Связанные организации.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyFindAffiliatedResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"query":"7727439844","suggestions":[{"value":"ООО \"ФАКТОР-М\"","inn":"7708446211","ogrn":"1247700836250","kpp":"770801001","type":"LEGAL","name":{"full":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ФАКТОР-М\"","short":"ООО \"ФАКТОР-М\"","latin":null,"clean":"ФАКТОР-М"},"opf":{"code":"12300","short":"ООО","full":"Общество с ограниченной ответственностью","type":"2014"},"okveds":[{"code":"46.73","name":"Торговля оптовая лесоматериалами, строительными материалами и санитарно-техническим оборудованием","main":true,"type":"2014"},{"code":"16.10","name":"Распиловка и строгание древесины","main":false,"type":"2014"}],"address":{"value":"г Москва, туп Сретенский, д 2, пом 4/4","full":"107045, Москва г, туп Сретенский, д 2, пом 4/4","level":"flat","is_active":true,"federal_district":"Центральный","address":{"region":"Москва г","city":"Москва","street":"Сретенский","house":"2","flat":"4/4"},"components":{"region":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"city":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"city_area":{"name":"Центральный","type":"округ","fias_id":null,"kladr_id":null},"city_district":{"name":"Красносельский","type":"р-н","fias_id":null,"kladr_id":null},"street":{"name":"Сретенский","type":"туп","fias_id":"b544c446-36fa-4556-ad66-85f596b06b27","kladr_id":"77000000000068800"},"house":{"name":"2","type":"д","block":null,"fias_id":"66c8c8fe-9fc1-47b7-ac99-791c68056645","kladr_id":"7700000000006880001","flat_count":null},"flat":{"name":"4/4","type":"пом","fias_id":"2c7dae2f-5a72-4e26-a845-f031eaee614b","kladr_id":null}},"codes":{"postal":"107045","kladr":"7700000000006880001","region_kladr":"7700000000000","region_iso":"RU-MOW","okato":"45286565000","oktmo":"45378000","tax_office":"7708","tax_office_legal":"7708"},"fias_id":"2c7dae2f-5a72-4e26-a845-f031eaee614b","fias_level":9,"geo":{"lat":55.766091,"lon":37.631639,"precision":"exact"},"metro":[{"name":"Сретенский бульвар","line":"Люблинско-Дмитровская","distance":0.32},{"name":"Тургеневская","line":"Калужско-Рижская","distance":0.39}],"cadastral_num":"77:01:0001086:3400"},"state":{"status":"ACTIVE","code":null,"name":null,"exclusion_decision":null,"egrul_changed_at":null,"actuality_date":"2026-06-01","registration_date":"2024-12-26","liquidation_date":null},"ogrn_date":"2024-12-26","invalid":{"code":"2","name":"сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)","date":"2026-05-18"},"codes":{"okpo":"79225713","okato":"45286565000","oktmo":"45378000000","okogu":"4210014","okfs":"16"},"kpp_largest":null,"branch_type":"MAIN","branch_count":0,"management":{"name":"КОЛЕСНИЧЕНКО СЕРГЕЙ АЛЕКСАНДРОВИЧ","post":"ДИРЕКТОР","post_type":"Руководитель юридического лица","start_date":"2025-08-28","disqualified":null},"capital":{"type":"УСТАВНЫЙ КАПИТАЛ","value":20000},"revenue":448562000,"smb":null,"employee_count":1,"founders":[{"inn":"7727439844","ogrn":null,"name":null,"fio":null,"type":null,"share":null}],"managers":[{"inn":"631551839216","ogrn":null,"name":null,"fio":null,"type":null,"share":null,"post":null}],"tax_regimes":null,"finance":null,"emails":["LEHARODIONOVPP7871@RAMBLER.RU"],"phones":null,"sites":null,"licenses":null,"authorities":null,"documents":null,"predecessors":null,"successors":null}]}},"sparse":{"summary":"Ответ с минимумом полей","value":{"query":"166002478718","suggestions":[{"value":"СНТ \"МОНТАЖНИК\"","inn":"1616004558","ogrn":"1021600815125","kpp":"161601001","type":"LEGAL","name":{"full":"САДОВОДЧЕСКОЕ НЕКОММЕРЧЕСКОЕ ТОВАРИЩЕСТВО \"МОНТАЖНИК\"","short":"СНТ \"МОНТАЖНИК\"","latin":null,"clean":"СНТ МОНТАЖНИК"},"opf":{"code":"20702","short":"СНТ","full":"Садоводческие или огороднические некоммерческое товарищество","type":"2014"},"okveds":[{"code":"68.32.1","name":"Управление эксплуатацией жилого фонда за вознаграждение или на договорной основе","main":true,"type":"2014"},{"code":"68.32.2","name":"Управление эксплуатацией нежилого фонда за вознаграждение или на договорной основе","main":false,"type":"2014"}],"address":{"value":"г Казань","full":"Татарстан респ, г Казань","level":"city","is_active":true,"confidence":0.4846,"federal_district":"Приволжский","address":{"region":"Татарстан респ","city":"Казань"},"components":{"region":{"name":"Татарстан","type":"респ","fias_id":"0c089b04-099e-4e0e-955a-6bf1ce525f1a","kladr_id":"1600000000000"},"city":{"name":"Казань","type":"г","fias_id":"93b3df57-4c89-44df-ac42-96f05e9cd3b9","kladr_id":"1600000100000"}},"codes":{"kladr":"1600000100000","region_kladr":"1600000000000","region_iso":"RU-TA","fias_code":"1600000100000000000","okato":"92401000000","oktmo":"92701000001","tax_office":"1600","tax_office_legal":"1600"},"fias_id":"93b3df57-4c89-44df-ac42-96f05e9cd3b9","fias_level":4,"geo":{"lat":55.811776,"lon":49.143048,"precision":"city"},"capital_marker":"3"},"state":{"status":"ACTIVE","code":null,"name":null,"exclusion_decision":null,"egrul_changed_at":null,"actuality_date":"2026-05-24","registration_date":"1995-11-12","liquidation_date":null},"ogrn_date":"2002-12-04","invalid":null,"codes":{"okpo":"42128843","okato":"92401385000","oktmo":"92701000001","okogu":"4210014","okfs":"16"},"kpp_largest":null,"branch_type":"MAIN","branch_count":0,"management":{"name":"ЕРЕМИНА ВАЛЕНТИНА АЛЕКСАНДРОВНА","post":"ПРЕДСЕДАТЕЛЬ ПРАВЛЕНИЯ","post_type":"Руководитель юридического лица","start_date":"2024-08-16","disqualified":null},"capital":null,"revenue":null,"smb":null,"employee_count":null,"founders":null,"managers":[{"inn":"166002478718","ogrn":null,"name":null,"fio":null,"type":null,"share":null,"post":null}],"tax_regimes":null,"finance":null,"emails":[],"phones":null,"sites":null,"licenses":null,"authorities":null,"documents":null,"predecessors":null,"successors":null}]}}}}}},"PartyFindByEmailOk":{"description":"Организации с этим адресом почты.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartyFindByEmailResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"query":"USLLUGI2024@GMAIL.COM","suggestions":[{"value":"ООО \"ЗАРЕЯ\"","inn":"9718249495","ogrn":"1247700175755","kpp":"771801001","type":"LEGAL","name":{"full":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ЗАРЕЯ\"","short":"ООО \"ЗАРЕЯ\"","latin":null,"clean":"ЗАРЕЯ"},"opf":{"code":"12300","short":"ООО","full":"Общество с ограниченной ответственностью","type":"2014"},"okveds":[{"code":"46.49.49","name":"Торговля оптовая прочими потребительскими товарами, не включенными в другие группировки","main":true,"type":"2014"},{"code":"43.21","name":"Производство электромонтажных работ","main":false,"type":"2014"}],"address":{"value":"г Москва, ул Амурская, д 1А к 4, пом 2Н","full":"107553, Москва г, ул Амурская, д 1А к 4, пом 2Н","level":"flat","is_active":true,"federal_district":"Центральный","address":{"region":"Москва г","city":"Москва","street":"Амурская","house":"1А к 4","flat":"2Н"},"components":{"region":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"city":{"name":"Москва","type":"г","fias_id":"0c5b2444-70a0-4932-980c-b4dc0d3f02b5","kladr_id":"7700000000000"},"city_area":{"name":"Восточный","type":"округ","fias_id":null,"kladr_id":null},"street":{"name":"Амурская","type":"ул","fias_id":"e870e330-0c60-4210-bda3-95c11dd69e5b","kladr_id":"77000000000074200"},"house":{"name":"1А","type":"д","block":"к 4","fias_id":"f6b2f6cf-f693-4520-b84b-aeea0bad523c","kladr_id":"7700000000007420299","flat_count":null},"flat":{"name":"2Н","type":"пом","fias_id":"ca52a746-2507-431c-98bb-98bc2bc6ba53","kladr_id":null}},"codes":{"postal":"107553","kladr":"7700000000007420299","region_kladr":"7700000000000","region_iso":"RU-MOW","okato":"45263564000","oktmo":"45305000","tax_office":"7718","tax_office_legal":"7718"},"fias_id":"ca52a746-2507-431c-98bb-98bc2bc6ba53","fias_level":9,"geo":{"lat":55.80778,"lon":37.757969,"precision":"exact"},"metro":[{"name":"Локомотив","line":"Московское центральное кольцо","distance":0.87},{"name":"Черкизовская","line":"Сокольническая","distance":0.93}],"cadastral_num":"77:03:0002007:2498"},"state":{"status":"LIQUIDATED","code":"415","name":null,"exclusion_decision":null,"egrul_changed_at":null,"actuality_date":"2026-07-10","registration_date":"2024-02-20","liquidation_date":"2026-07-10"},"ogrn_date":"2024-02-20","invalid":{"code":"2","name":"сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)","date":"2025-09-24"},"codes":{"okpo":"87083658","okato":"45263564000","oktmo":"45305000000","okogu":"4210014","okfs":"16"},"kpp_largest":null,"branch_type":"MAIN","branch_count":0,"management":{"name":"ПАВЛОВ АЛЕКСЕЙ АЛЕКСАНДРОВИЧ","post":"ГЕНЕРАЛЬНЫЙ ДИРЕКТОР","post_type":"Руководитель юридического лица","start_date":"2025-05-16","disqualified":null},"capital":{"type":"УСТАВНЫЙ КАПИТАЛ","value":30000},"revenue":null,"smb":null,"employee_count":null,"founders":[{"inn":"344106419674","ogrn":null,"name":null,"fio":null,"type":null,"share":null}],"managers":[{"inn":"344106419674","ogrn":null,"name":null,"fio":null,"type":null,"share":null,"post":null}],"tax_regimes":null,"finance":null,"emails":["USLLUGI2024@GMAIL.COM"],"phones":null,"sites":null,"licenses":null,"authorities":null,"documents":null,"predecessors":null,"successors":null}]}},"sparse":{"summary":"Ответ с минимумом полей","value":{"query":"VIVADENT2014@YANDEX.RU","suggestions":[{"value":"ИП ТРУБИЦЫН СЕРГЕЙ ВЛАДИМИРОВИЧ","inn":"362700805900","ogrn":"318366800062524","type":"INDIVIDUAL","name":{"full":"ТРУБИЦЫН СЕРГЕЙ ВЛАДИМИРОВИЧ","short":"ИП ТРУБИЦЫН СЕРГЕЙ ВЛАДИМИРОВИЧ","latin":null,"clean":"ТРУБИЦЫН СЕРГЕЙ ВЛАДИМИРОВИЧ"},"fio":{"surname":"ТРУБИЦЫН","name":"СЕРГЕЙ","patronymic":"ВЛАДИМИРОВИЧ"},"opf":{"code":"50102","short":"ИП","full":"Индивидуальный предприниматель","type":"2014"},"okveds":[{"code":"86.23","name":"Стоматологическая практика","main":true,"type":"2014"}],"address":{"value":"Воронежская обл","full":"Воронежская обл","level":"region","is_active":true,"federal_district":"Центральный","address":{"region":"Воронежская обл"},"components":{"region":{"name":"Воронежская","type":"обл","fias_id":"b756fe6b-bbd3-44d5-9302-5bfcc740f46e","kladr_id":"3600000000000"}},"codes":{"kladr":"3600000000000","region_kladr":"3600000000000","region_iso":"RU-VOR","fias_code":"3600000000000000000","okato":"20000000000","oktmo":"20000000","tax_office":"3600","tax_office_legal":"3600"},"fias_id":"b756fe6b-bbd3-44d5-9302-5bfcc740f46e","fias_level":1,"geo":{"lat":51.349682,"lon":39.553082,"precision":"district"}},"state":{"status":"ACTIVE","code":null,"name":null,"exclusion_decision":null,"egrul_changed_at":null,"actuality_date":"2026-04-28","registration_date":"2018-06-28","liquidation_date":null},"ogrn_date":"2018-06-28","codes":{"okpo":null,"okato":null,"oktmo":null,"okogu":null,"okfs":null},"revenue":null,"smb":{"category":"MICRO","issued_at":"2018-07-10"},"employee_count":null,"tax_regimes":["УСН"],"finance":null,"emails":["VIVADENT2014@YANDEX.RU"],"phones":null,"sites":null,"licenses":null,"authorities":null,"documents":null,"citizenship":null,"gender":null}]}}}}}},"BankSuggestOk":{"description":"Подсказки банков.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankSuggestResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"query":"УФК по Респуб","suggestions":[{"value":"УФК по Республике Коми","bic":"018702501","correspondent_account":null,"registration_number":null,"city":"г Сыктывкар","region":"87","address":"ул. Громова, д. 45","participant_type":null,"swift":null,"status":"ACTIVE"},{"value":"УФК по Республике Крым","bic":"046709101","correspondent_account":null,"registration_number":null,"city":"г Симферополь","region":"67","address":"ул Севастопольская, 19","participant_type":null,"swift":null,"status":"ACTIVE"}]}},"sparse":{"summary":"Ответ с минимумом полей","value":{"query":"Международный банк ре","suggestions":[{"value":"Международный банк реконструкции и развития","bic":"245001229","correspondent_account":null,"registration_number":null,"city":null,"region":"00","address":null,"participant_type":null,"swift":null,"status":"ACTIVE"}]}}}}}},"BankFindByIdOk":{"description":"Банк по БИК.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BankFindByIdResponse"},"examples":{"rich":{"summary":"Полный ответ","value":{"query":"040173745","suggestions":[{"value":"\"СИБСОЦБАНК\" ООО","bic":"040173745","correspondent_account":"30101810800000000745","registration_number":"2015","city":"г Барнаул","region":"01","address":"пр-т Ленина, 61 А","participant_type":"branch","swift":"SISNRU55XXX","status":"ACTIVE"}]}},"sparse":{"summary":"Ответ с минимумом полей","value":{"query":"245001228","suggestions":[{"value":"МЕЖДУНАРОДНЫЙ ВАЛЮТНЫЙ ФОНД","bic":"245001228","correspondent_account":null,"registration_number":null,"city":null,"region":"00","address":null,"participant_type":null,"swift":null,"status":"ACTIVE"}]}}}}}},"Unauthorized":{"description":"Нет ключа или ключ не найден.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}}},"Forbidden":{"description":"Ключ не может вызвать этот метод.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}}},"TooManyRequests":{"description":"Превышен лимит.","headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsError"}}}},"BadGateway":{"description":"Узел обработки не ответил.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}}},"ServiceUnavailable":{"description":"Сервис временно недоступен.","headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableError"}}}},"PhoneFindOk":{"description":"Один номер — query и suggestions; пакет — results в порядке входа.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PhoneFindResponse"},"examples":{"free":{"summary":"Тип номера: без phone_mnp","value":{"query":"89627302371","suggestions":[{"source":"89627302371","phone":"+7 962 730-23-71","type":"mobile","is_valid":true,"country_code":"7","city_code":"962","number":"7302371","extension":null,"country":"Россия","region":"Республика Саха (Якутия)","city":null,"timezone":"UTC+9","qc":0,"qc_conflict":0}]}},"mnp":{"summary":"Оператор: с phone_mnp, неизвестные данные null","value":{"query":"89627302371","suggestions":[{"source":"89627302371","phone":"+7 962 730-23-71","type":"mobile","is_valid":true,"country_code":"7","city_code":"962","number":"7302371","extension":null,"operator":"ПАО \"ВЫМПЕЛКОМ\"","operator_inn":null,"operator_original":null,"ported":false,"mcc":null,"mnc":null,"country":"Россия","region":"Республика Саха (Якутия)","city":null,"timezone":"UTC+9","qc":0,"qc_conflict":0}]}}}}}},"AccountOk":{"description":"Лимиты ключа и денежный баланс владельца.","headers":{"Cache-Control":{"description":"Ответ запрещено сохранять в HTTP-кэше.","schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"},"examples":{"configured":{"summary":"Настроенные лимиты и положительный баланс","value":{"limits":{"rps":1000,"daily":{"suggestions":100000}},"balance":123.45}},"unlimited":{"summary":"Без настроенных лимитов, нулевой баланс","value":{"limits":{"rps":null,"daily":{}},"balance":0.0}},"negative":{"summary":"Отрицательный баланс","value":{"limits":{"rps":10,"daily":{}},"balance":-1.0}},"large":{"summary":"Крупный баланс","value":{"limits":{"rps":10,"daily":{}},"balance":50000000.0}}}}}},"AccountUnauthorized":{"description":"Ключ отсутствует, не найден либо неверно передан.","headers":{"Cache-Control":{"description":"Ответ запрещено сохранять в HTTP-кэше.","schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountUnauthorizedError"}}}},"AccountForbidden":{"description":"Ключ отключён, публичный или запрещён ограничениями IP/Origin.","headers":{"Cache-Control":{"description":"Ответ запрещено сохранять в HTTP-кэше.","schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountForbiddenError"}}}},"AccountBillingUnavailable":{"description":"Баланс временно недоступен. Повторите запрос позже.","headers":{"Cache-Control":{"description":"Ответ запрещено сохранять в HTTP-кэше.","schema":{"type":"string","const":"no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountBillingUnavailableError"}}}}}}}