Запрос

Для пользователей подсказок DaData.ru:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "волы" }' \
  https://dadata.ru/api/v2/suggest/party

Для пользователей standalone-подсказок:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "волы" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/party

Параметры

ПараметрОбязательный?Описание
queryдаЗапрос, для которого нужно получить подсказки
count
нет
status
нетОграничение по статусу организации
type
нетОграничение по типу организации
locations
нет

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

Ответ

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

Примеры

Запрос:

{
  "query": "волы" 
}

Ответ:

{
    "suggestions": [
        {
            "value": "ЗАО Волы",
            "unrestricted_value": "ЗАО Волы",
            "data": {
                "kpp": "770901001",
                "management": {
                    "name": "Еремин Денис Андреевич",
                    "post": "Генеральный директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "address": {
                    "value": "109004, Москва г, Земляной Вал ул, 68/18, СТР.3",
                    "unrestricted_value": "109004, Москва г, Земляной Вал ул, 68/18, СТР.3",
                    "data": null
                },
                "type": "LEGAL",
                "opf": {
                    "code": "12267",
                    "full": "Закрытое акционерное общество",
                    "short": "ЗАО"
                },
                "name": {
                    "latin": null,
                    "full": "ВОЛЫ",
                    "short": "Волы"
                },
                "inn": "7709420914",
                "ogrn": "1037709040753",
                "okpo": "14224803",
                "okved": "63.40",
                "state": {
                    "status": "ACTIVE",
                    "registration_date": 1052164800000,
                    "liquidation_date": null
                }
            }
        }
    ]
}

Запрос:

<req>
  <query>волы</query>
</req>

Ответ:

<SuggestResponse>
    <suggestions>
        <value>ЗАО Волы</value>
        <unrestricted_value>ЗАО Волы</unrestricted_value>
        <data>
            <kpp>770901001</kpp>
            <management>
                <name>Еремин Денис Андреевич</name>
                <post>Генеральный директор</post>
            </management>
            <branch_type>MAIN</branch_type>
            <branch_count>1</branch_count>
            <address>
                <value>109004, Москва г, Земляной Вал ул, 68/18, СТР.3</value>
                <unrestricted_value>109004, Москва г, Земляной Вал ул, 68/18, СТР.3</unrestricted_value>
                <data/>
            </address>
            <type>LEGAL</type>
            <opf>
                <code>12267</code>
                <full>Закрытое акционерное общество</full>
                <short>ЗАО</short>
            </opf>
            <name>
                <latin/>
                <full>ВОЛЫ</full>
                <short>Волы</short>
            </name>
            <inn>7709420914</inn>
            <ogrn>1037709040753</ogrn>
            <okpo>14224803</okpo>
            <okved>63.40</okved>
            <state>
                <status>ACTIVE</status>
                <registration_date>1052164800000</registration_date>
                <liquidation_date/>
            </state>
        </data>
    </suggestions>
</SuggestResponse>