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

Данные о физлице

Данные о физическом лице по ИНН (12 цифр): ФИО, признак дисквалификации, связанные организации и ИП с указанием ролей (руководитель, учредитель, ИП).

GET https://kontrchk.ru/api/v2/persons
  • Обязательный параметр — inn (12 цифр), параметр ogrn не используется.
  • counterparties содержит список организаций, с которыми связано физлицо.

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

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

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

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

ИНН организации (10 цифр) или ИП (12 цифр). Используется, если не указан ogrn.

Пример: 7707083893
Шаблон: ^\d{10}$|^\d{12}$

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

URL 
https://kontrchk.ru/api/v2/persons?key=ВАШ_КЛЮЧ&inn=325506275105
cURL 
curl -s -H "Accept: application/json" "https://kontrchk.ru/api/v2/persons?key=ВАШ_КЛЮЧ&inn=325506275105"

Ответ

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

Response schema
person_innstring

ИНН физического лица.

person_namestring

ФИО.

disqualified_personboolean

Дисквалифицированное лицо.

has_finance_databoolean

Есть финансовые данные.

counterpartiesarray[object]

Связанные организации и ИП.

aggregate_ratingobject

Агрегированный рейтинг.

Пример JSON 
{
    "counterparties": [
        {
            "id": "314325632100026",
            "name": "РОМАНЧЕНКО ЕВГЕНИЙ СЕРГЕЕВИЧ",
            "ogrn": "314325632100026",
            "inn": "325506275105",
            "roles": [
                {
                    "type": "IP",
                    "position": "Индивидуальный предприниматель"
                }
            ],
            "establishment_date": "2014-11-17",
            "type": "ip",
            "status": 0
        }
    ],
    "person_name": "РОМАНЧЕНКО ЕВГЕНИЙ СЕРГЕЕВИЧ",
    "person_inn": "325506275105",
    "disqualified_person": false,
    "has_finance_data": false,
    "aggregate_rating": {
        "rating_value": 4.5,
        "rating_count": 1017
    }
}