Запрос

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

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "волы" }' \
  http://suggestions.dadata.ru/suggestions/api/4_1/rs/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": "г Москва, ул Земляной Вал, д 68/18 стр 3",
                    "unrestricted_value": "г Москва, ул Земляной Вал, д 68/18 стр 3",
                    "data": {
                        "qc_complete": null,
                        "qc_house": null,
                        "qc_geo": null,
                        "postal_code": "109004",
                        "postal_box": null,
                        "country": "Россия",
                        "region_with_type": "г Москва",
                        "region_type": "г",
                        "region_type_full": "город",
                        "region": "Москва",
                        "area_with_type": null,
                        "area_type": null,
                        "area_type_full": null,
                        "area": null,
                        "city_with_type": "г Москва",
                        "city_type": "г",
                        "city_type_full": "город",
                        "city": "Москва",
                        "settlement_with_type": null,
                        "settlement_type": null,
                        "settlement_type_full": null,
                        "settlement": null,
                        "street_with_type": "ул Земляной Вал",
                        "street_type": "ул",
                        "street_type_full": "улица",
                        "street": "Земляной Вал",
                        "house_type": "д",
                        "house_type_full": "дом",
                        "house": "68/18",
                        "block_type": "стр",
                        "block": "3",
                        "flat_area": null,
                        "flat_type": null,
                        "flat": null,
                        "fias_id": "a9df9ae2-c5ac-4a87-8735-ca99ba2b11f1",
                        "kladr_id": "7700000000013400140",
                        "tax_office": "7709",
                        "tax_office_legal": null,
                        "okato": "45286580000",
                        "oktmo": "45381000",
                        "geo_lat": null,
                        "geo_lon": null,
                        "unparsed_parts": null,
                        "qc": null
                    }
                },
                "type": "LEGAL",
                "opf": {
                    "code": "12267",
                    "full": "Закрытое акционерное общество",
                    "short": "ЗАО"
                },
                "name": {
                    "full_with_opf": "Закрытое акционерное общество \"Волы\"",
                    "short_with_opf": "ЗАО \"Волы\"",
                    "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>г Москва, ул Земляной Вал, д 68/18 стр 3</value>
                <unrestricted_value>г Москва, ул Земляной Вал, д 68/18 стр 3</unrestricted_value>
                <data>
                    <qc_complete/>
                    <qc_house/>
                    <qc_geo/>
                    <postal_code>109004</postal_code>
                    <postal_box/>
                    <country>Россия</country>
                    <region_with_type>г Москва</region_with_type>
                    <region_type>г</region_type>
                    <region_type_full>город</region_type_full>
                    <region>Москва</region>
                    <area_with_type/>
                    <area_type/>
                    <area_type_full/>
                    <area/>
                    <city_with_type>г Москва</city_with_type>
                    <city_type>г</city_type>
                    <city_type_full>город</city_type_full>
                    <city>Москва</city>
                    <settlement_with_type/>
                    <settlement_type/>
                    <settlement_type_full/>
                    <settlement/>
                    <street_with_type>ул Земляной Вал</street_with_type>
                    <street_type>ул</street_type>
                    <street_type_full>улица</street_type_full>
                    <street>Земляной Вал</street>
                    <house_type>д</house_type>
                    <house_type_full>дом</house_type_full>
                    <house>68/18</house>
                    <block_type>стр</block_type>
                    <block>3</block>
                    <flat_area/>
                    <flat_type/>
                    <flat/>
                    <fias_id>a9df9ae2-c5ac-4a87-8735-ca99ba2b11f1</fias_id>
                    <kladr_id>7700000000013400140</kladr_id>
                    <tax_office>7709</tax_office>
                    <tax_office_legal/>
                    <okato>45286580000</okato>
                    <oktmo>45381000</oktmo>
                    <geo_lat/>
                    <geo_lon/>
                    <unparsed_parts/>
                    <qc/>
                </data>
            </address>
            <type>LEGAL</type>
            <opf>
                <code>12267</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>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>