Просмотреть исходный

Запрос

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

Ответ

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

Примеры

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

Запрос (JSON):

{
  "query": "Сбербанк" 
}

"suggestions": [
        {
            "value": "ОАО Сбербанк России",
            "unrestricted_value": "ОАО Сбербанк России",
            "data": {
                "kpp": "775001001",
                "management": {
                    "name": "Греф Герман Оскарович",
                    "post": "Президент-председатель правления"
                },
                "branch_type": "MAIN",
                "branch_count": 1692,
                "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": 1429056000000,
                    "registration_date": 677376000000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Москва, ул Вавилова, д 19",
                    "unrestricted_value": "г Москва, ул Вавилова, д 19",
                    "data": {
                        "qc_complete": null,
                        "qc_house": null,
                        "qc_geo": null,
                        "postal_code": "117312",
                        "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": "19",
                        "block_type": null,
                        "block": null,
                        "flat_area": null,
                        "flat_type": null,
                        "flat": null,
                        "fias_id": "93409d8c-d8d4-4491-838f-f9aa1678b5e6",
                        "kladr_id": "7700000000009240170",
                        "tax_office": "7736",
                        "tax_office_legal": null,
                        "okato": "45293554000",
                        "oktmo": "45397000",
                        "geo_lat": null,
                        "geo_lon": null,
                        "unparsed_parts": null,
                        "qc": null
                    }
                }
            }
        }
    ]

Запрос (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>1692</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>1429056000000</actuality_date>
                <registration_date>677376000000</registration_date>
                <liquidation_date/>
            </state>
            <address>
                <value>г Москва, ул Вавилова, д 19</value>
                <unrestricted_value>г Москва, ул Вавилова, д 19</unrestricted_value>
                <data>
                    <qc_complete/>
                    <qc_house/>
                    <qc_geo/>
                    <postal_code>117312</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>19</house>
                    <block_type/>
                    <block/>
                    <flat_area/>
                    <flat_type/>
                    <flat/>
                    <fias_id>93409d8c-d8d4-4491-838f-f9aa1678b5e6</fias_id>
                    <kladr_id>7700000000009240170</kladr_id>
                    <tax_office>7736</tax_office>
                    <tax_office_legal/>
                    <okato>45293554000</okato>
                    <oktmo>45397000</oktmo>
                    <geo_lat/>
                    <geo_lon/>
                    <unparsed_parts/>
                    <qc/>
                </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": "12165",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    "full_with_opf": "Общество с ограниченной ответственностью \"Ромашка\"",
                    "short_with_opf": "ООО \"Ромашка\"",
                    "latin": null,
                    "full": "Ромашка",
                    "short": "Ромашка"
                },
                "inn": "2222808138",
                "ogrn": "1122223013120",
                "okpo": "10025969",
                "okved": "52.3",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1422057600000,
                    "registration_date": 1350950400000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "unrestricted_value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "data": {
                        "qc_complete": null,
                        "qc_house": null,
                        "qc_geo": null,
                        "postal_code": "656902",
                        "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": "село Власиха",
                        "settlement_type": "с",
                        "settlement_type_full": "село",
                        "settlement": "Власиха",
                        "street_with_type": "ул Берестовая",
                        "street_type": "ул",
                        "street_type_full": "улица",
                        "street": "Берестовая",
                        "house_type": "д",
                        "house_type_full": "дом",
                        "house": "54",
                        "block_type": null,
                        "block": null,
                        "flat_area": null,
                        "flat_type": null,
                        "flat": null,
                        "fias_id": "c67c8394-ae02-4379-91c6-f755e0f1c1b2",
                        "kladr_id": "2200000100600690027",
                        "tax_office": "2223",
                        "tax_office_legal": null,
                        "okato": "01401916001",
                        "oktmo": "01701000126",
                        "geo_lat": null,
                        "geo_lon": null,
                        "unparsed_parts": null,
                        "qc": null
                    }
                }
            }
        }
    ]
}

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

Запрос:

{
  "query": "Коварский Станислав Альбертович" 
}

{
    "suggestions": [
        {
            "value": "ООО ОГРАДА",
            "unrestricted_value": "ООО ОГРАДА",
            "data": {
                "kpp": "781101001",
                "management": {
                    "name": "Коварский Станислав Альбертович",
                    "post": "Генеральный директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12165",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ОГРАДА\"",
                    "short_with_opf": "ООО \"ОГРАДА\"",
                    "latin": null,
                    "full": "ОГРАДА",
                    "short": "ОГРАДА"
                },
                "inn": "7811585868",
                "ogrn": "1147847263607",
                "okpo": null,
                "okved": "28.52",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1418256000000,
                    "registration_date": 1406505600000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Санкт-Петербург, пр-кт Обуховской Обороны, д 69В, кв 3Н",
                    "unrestricted_value": "г Санкт-Петербург, пр-кт Обуховской Обороны, д 69В, кв 3Н",
                    "data": {
                        "qc_complete": null,
                        "qc_house": null,
                        "qc_geo": null,
                        "postal_code": "192029",
                        "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": "69В",
                        "block_type": null,
                        "block": null,
                        "flat_area": null,
                        "flat_type": "кв",
                        "flat": "3Н",
                        "fias_id": "ff4ba43a-61a3-489d-af9d-92b4db1cac77",
                        "kladr_id": "7800000000009540182",
                        "tax_office": "7811",
                        "tax_office_legal": null,
                        "okato": "40285561000",
                        "oktmo": "40378000",
                        "geo_lat": null,
                        "geo_lon": null,
                        "unparsed_parts": null,
                        "qc": null
                    }
                }
            }
        }
    ]
}