Данные о контрагенте

Похожие организации

Возвращает список организаций, схожих с указанным контрагентом: по выручке, виду деятельности, региону, численности, ОПФ и др. Поддерживается фильтр по регионам регистрации.

GET https://kontrchk.ru/api/v2/lookalike
  • limit — количество результатов (1–100), по умолчанию 20.
  • regions — коды регионов (2 цифры). Можно передать несколько значений. Справочник — dict_regions.
  • Поле criterias содержит коды критериев сходства (INCOME, REGION, ACTIVITY_KIND и др.).
  • Ответ кэшируется на сервере (TTL 1 час).

Параметры запроса

Query parameters
Параметр Тип Описание
key string обязательный

API-ключ. Также можно передать в заголовке X-API-Key.

Пример: ВАШ_КЛЮЧ
ogrn string обязательный

ОГРН (13 цифр) или ОГРНИП (15 цифр).

Пример: 1027700132195
Шаблон: ^\d{13}$|^\d{15}$
limit integer необязательный

Количество похожих организаций (1–100). По умолчанию 20.

Пример: 20
По умолчанию: 20
regions string|array необязательный

Фильтр по регионам регистрации. Коды — справочник dict_regions.

Пример: 77

Пример запроса

URL 
https://kontrchk.ru/api/v2/lookalike?key=ВАШ_КЛЮЧ&ogrn=1027700132195&limit=20
cURL 
curl -s -H "Accept: application/json" "https://kontrchk.ru/api/v2/lookalike?key=ВАШ_КЛЮЧ&ogrn=1027700132195&limit=20"

Ответ

Успешный ответ пример ответа

Response schema
counterpartiesarray[object]

Похожие организации.

totalCountinteger

Общее количество похожих организаций.

Пример: 42
criteriasarray[string]

Критерии сходства: INCOME, REGION, ACTIVITY_KIND и др.

Пример: ["INCOME","REGION"]
Пример JSON 
{
    "success": true,
    "data": {
        "counterparties": [
            {
                "ogrn": "1027700070518",
                "inn": "7736050003",
                "name": "Организация (пример)",
                "opf": "ПАО",
                "score": 0.87,
                "main_okved": "64.19",
                "activity_kind_dsc": "Денежное посредничество",
                "region": "Москва",
                "ssch": 12500,
                "counterparty_status": {
                    "status_rus_short": "Действует",
                    "color": "green"
                }
            }
        ],
        "totalCount": 42,
        "criterias": [
            "INCOME",
            "REGION",
            "ACTIVITY_KIND"
        ]
    }
}