Запрос

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "Сбербанк" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/party

Параметры

ПараметрОбязательный?Описание
queryдаЗапрос, для которого нужно получить подсказки.
Можно искать по:
  • названию компании (либо ФИО для ИП);
  • ИНН;
  • КПП (с версии 19.4);
  • ОГРН;
  • адресу до улицы;
  • ФИО руководителей компании (с версии 19.10) 
count
нет
status
нетОграничение по статусу организации
type
нетОграничение по типу организации
locations
нет

Ограничение по региону

locations_boost
нетПриоритет города при ранжировании

Ответ

Возвращается список объектов организации:

Примеры

Поиск по названию компании

Запрос (JSON):

{
  "query": "Сбербанк" 
}
"suggestions": [
        {
            "value": "ПАО СБЕРБАНК",
            "unrestricted_value": "ПАО СБЕРБАНК",
            "data": {
                "kpp": "775001001",
                "management": {
                    "name": "Греф Герман Оскарович",
                    "post": "Президент-председатель правления"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12247",
                    "full": "Публичное акционерное общество",
                    "short": "ПАО"
                },
                "name": {
                    "full_with_opf": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
                    "short_with_opf": "ПАО СБЕРБАНК",
                    "latin": null,
                    "full": "СБЕРБАНК РОССИИ",
                    "short": "СБЕРБАНК"
                },
                "inn": "7707083893",
                "ogrn": "1027700132195",
                "okpo": null,
                "okved": null,
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1443312000000,
                    "registration_date": 677376000000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Москва, ул Вавилова, д 19",
                    "unrestricted_value": "г Москва, ул Вавилова, д 19",
                    "data": {
						...
                    }
                }
            }
        ]

Запрос (XML):

<req>
  <query>Сбербанк</query>
</req>
<SuggestResponse>
    <suggestions>
        <value>ПАО СБЕРБАНК</value>
        <unrestricted_value>ПАО СБЕРБАНК</unrestricted_value>
        <data>
            <kpp>775001001</kpp>
            <management>
                <name>Греф Герман Оскарович</name>
                <post>Президент-председатель правления</post>
            </management>
            <branch_type>MAIN</branch_type>
            <branch_count>1</branch_count>
            <type>LEGAL</type>
            <opf>
                <code>12247</code>
                <full>Публичное акционерное общество</full>
                <short>ПАО</short>
            </opf>
            <name>
                <full_with_opf>ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"</full_with_opf>
                <short_with_opf>ПАО СБЕРБАНК</short_with_opf>
                <latin/>
                <full>СБЕРБАНК РОССИИ</full>
                <short>СБЕРБАНК</short>
            </name>
            <inn>7707083893</inn>
            <ogrn>1027700132195</ogrn>
            <okpo/>
            <okved/>
            <state>
                <status>ACTIVE</status>
                <actuality_date>1443312000000</actuality_date>
                <registration_date>677376000000</registration_date>
                <liquidation_date/>
            </state>
            <address>
                <value>г Москва, ул Вавилова, д 19</value>
                <unrestricted_value>г Москва, ул Вавилова, д 19</unrestricted_value>
                <data>
				...
                </data>
            </address>
        </data>
    </suggestions>
</SuggestResponse>

По ИНН

Запрос:

{
  "query": "2222808138" 
}
{
    "suggestions": [
        {
            "value": "ООО \"РОМАШКА\"",
            "unrestricted_value": "ООО \"РОМАШКА\"",
            "data": {
                "kpp": "222201001",
                "management": {
                    "name": "Миронов Вячеслав Леонидович",
                    "post": "Директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12300",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОМАШКА\"",
                    "short_with_opf": "ООО \"РОМАШКА\"",
                    "latin": null,
                    "full": "РОМАШКА",
                    "short": "РОМАШКА"
                },
                "inn": "2222808138",
                "ogrn": "1122223013120",
                "okpo": null,
                "okved": "52.3",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1440806400000,
                    "registration_date": 1350950400000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "unrestricted_value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "data": {
					...
                    }
                }
            }
        }
    ]
}

По ФИО руководителя

Запрос:

{
  "query": "Коварский Станислав Альбертович" 
}
{
    "suggestions": [
        {
            "value": "ООО \"ВЕГА\"",
            "unrestricted_value": "ООО \"ВЕГА\"",
            "data": {
                "kpp": "781401001",
                "management": {
                    "name": "Коварский Станислав Альбертович",
                    "post": "Генеральный директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12300",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВЕГА\"",
                    "short_with_opf": "ООО \"ВЕГА\"",
                    "latin": null,
                    "full": "ВЕГА",
                    "short": "ВЕГА"
                },
                "inn": "7814255120",
                "ogrn": "1157847228307",
                "okpo": null,
                "okved": "52.50.1",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1440806400000,
                    "registration_date": 1435795200000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Санкт-Петербург, ул Новосибирская, д 6А, кв 2Н",
                    "unrestricted_value": "г Санкт-Петербург, ул Новосибирская, д 6А, кв 2Н",
                    "data": {
					...
                    }
                }
            }
        }