Запрос

Для пользователей подсказок 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

Заголовки

ЗаголовокОписание
Content-Type

Тип данных в запроосе: application/json или application/xml

Accept
Тип данных в ответе: application/json или application/xml
Authorization

API-ключ в формате: Token ${API_KEY}

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

Параметры

ПараметрОбязательный?Описание
queryдаЗапрос, для которого нужно получить подсказки
count
нетКоличество возвращаемых подсказок (если не указано, используется значение по умолчанию).

Ответ

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

Примеры

Запрос:

{
  "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>