Запрос

Для пользователей подсказок 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
нетКоличество возвращаемых подсказок (если не указано, используется значение по умолчанию)
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>