Запрос

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

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

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

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

Параметры

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

Ответ

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

Примеры

Запрос:

{
  "query": "альфа" 
}

Ответ:

{
    "suggestions": [
        {
            "value": "АЛЬФА-БАНК",
            "unrestricted_value": "АЛЬФА-БАНК",
            "data": {
                "opf": {
                    "type": "BANK",
                    "full": "Банк",
                    "short": "Б"
                },
                "name": {
                    "payment": "АО \"АЛЬФА-БАНК\"",
                    "full": "АКЦИОНЕРНОЕ ОБЩЕСТВО \"АЛЬФА-БАНК\"",
                    "short": "АЛЬФА-БАНК"
                },
                "bic": "044525593",
                "swift": "ALFARUMMXXX",
                "okpo": "09610444",
                "correspondent_account": "30101810200000000593",
                "registration_number": "1326",
                "rkc": {
                    "opf": {
                        "type": "RKC",
                        "full": "Главное управление/Отделение (НБ)",
                        "short": "ГУ/О"
                    },
                    "name": {
                        "payment": "ГУ БАНКА РОССИИ ПО ЦФО",
                        "full": null,
                        "short": null
                    },
                    "bic": "044525000",
                    "swift": null,
                    "okpo": "09201220",
                    "correspondent_account": null,
                    "registration_number": null,
                    "rkc": null,
                    "address": {
                        "value": "115035, МОСКВА 35, УЛ.БАЛЧУГ,2",
                        "unrestricted_value": "115035, МОСКВА 35, УЛ.БАЛЧУГ,2",
                        "data": null
                    },
                    "phone": null,
                    "state": {
                        "status": "ACTIVE",
                        "actuality_date": 1453939200000,
                        "registration_date": 889488000000,
                        "liquidation_date": null
                    }
                },
                "address": {
                    "value": "г Москва, ул Каланчевская, д 27",
                    "unrestricted_value": "г Москва, ул Каланчевская, д 27",
                    "data": {
                        "qc_complete": null,
                        "qc_house": null,
                        "qc_geo": "0",
                        "postal_code": "107078",
                        "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": "Москва",
                        "city_district": "Красносельский р-н",
                        "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": "27",
                        "block_type": null,
                        "block_type_full": null,
                        "block": null,
                        "flat_area": null,
                        "square_meter_price": null,
                        "flat_price": null,
                        "flat_type": null,
                        "flat_type_full": null,
                        "flat": null,
                        "fias_id": "b587ebb8-2892-4826-ab85-42dc1523ba73",
                        "fias_level": "8",
                        "kladr_id": "7700000000006360032",
                        "tax_office": "7708",
                        "tax_office_legal": null,
                        "capital_marker": "0",
                        "okato": "45286565000",
                        "oktmo": "45378000",
                        "timezone": null,
                        "geo_lat": "55.7749202",
                        "geo_lon": "37.6503634",
                        "beltway_hit": null,
                        "beltway_distance": null,
                        "unparsed_parts": null,
                        "qc": null
                    }
                },
                "phone": null,
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1453939200000,
                    "registration_date": 759024000000,
                    "liquidation_date": null
                }
            }
		}
	]
}

Запрос:

<req>
  <query>втб 24</query>
</req>

Ответ:

<SuggestResponse>
    <suggestions>
        <value>ВТБ 24 (ПАО)</value>
        <unrestricted_value>ВТБ 24 (ПАО)</unrestricted_value>
        <data>
            <opf>
                <type>BANK</type>
                <full>Банк</full>
                <short>Б</short>
            </opf>
            <name>
                <payment>ВТБ 24 (ПАО)</payment>
                <full>БАНК ВТБ 24 (ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО)</full>
                <short>ВТБ 24 (ПАО)</short>
            </name>
            <bic>044525716</bic>
            <swift>CBGURUMMXXX</swift>
            <okpo>20606880</okpo>
            <correspondent_account>30101810100000000716</correspondent_account>
            <registration_number>1623</registration_number>
            <rkc>
                <opf>
                    <type>RKC</type>
                    <full>Главное управление/Отделение (НБ)</full>
                    <short>ГУ/О</short>
                </opf>
                <name>
                    <payment>ГУ БАНКА РОССИИ ПО ЦФО</payment>
                    <full/>
                    <short/>
                </name>
                <bic>044525000</bic>
                <swift/>
                <okpo>09201220</okpo>
                <correspondent_account/>
                <registration_number/>
                <rkc/>
                <address>
                    <value>115035, МОСКВА 35, УЛ.БАЛЧУГ,2</value>
                    <unrestricted_value>115035, МОСКВА 35, УЛ.БАЛЧУГ,2</unrestricted_value>
                    <data/>
                </address>
                <phone/>
                <state>
                    <status>ACTIVE</status>
                    <actuality_date>1453939200000</actuality_date>
                    <registration_date>889488000000</registration_date>
                    <liquidation_date/>
                </state>
            </rkc>
            <address>
                <value>г Москва, ул Мясницкая, д 35</value>
                <unrestricted_value>г Москва, ул Мясницкая, д 35</unrestricted_value>
                <data>
                    <qc_complete/>
                    <qc_house/>
                    <qc_geo>0</qc_geo>
                    <postal_code>101000</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>
                    <city_district>Красносельский р-н</city_district>
                    <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>35</house>
                    <block_type/>
                    <block_type_full/>
                    <block/>
                    <flat_area/>
                    <square_meter_price/>
                    <flat_price/>
                    <flat_type/>
                    <flat_type_full/>
                    <flat/>
                    <fias_id>51add53a-90b9-4934-a6e0-a23ba9ba5c95</fias_id>
                    <fias_level>8</fias_level>
                    <kladr_id>7700000000071190111</kladr_id>
                    <tax_office>7708</tax_office>
                    <tax_office_legal/>
                    <capital_marker>0</capital_marker>
                    <okato>45286565000</okato>
                    <oktmo>45378000</oktmo>
                    <timezone/>
                    <geo_lat>55.7657887</geo_lat>
                    <geo_lon>37.6386041</geo_lon>
                    <beltway_hit/>
                    <beltway_distance/>
                    <unparsed_parts/>
                    <qc/>
                </data>
            </address>
            <phone/>
            <state>
                <status>ACTIVE</status>
                <actuality_date>1453939200000</actuality_date>
                <registration_date>759024000000</registration_date>
                <liquidation_date/>
            </state>
        </data>
    </suggestions>
</SuggestResponse>