Ваши комментарии

Вот так:

<req>
  <query>минск</query>
  <locations>
    <country>*</country>
  </locations>
</req>

Нормальный вариант, если вы не полагаетесь на hid как на «долгоживущий» идентификатор.

Поиск аффилированных компаний для учредителей и руководителей

В поиске аффилированных компаний теперь можно искать только по учредителям, только по руководителям, или по тем и другим (по умолчанию). Заодно увеличили максимальное количество результатов до 300 (параметр count), чтобы даже по Сбербанку можно было получить все компании, которые он учредил.

Чтобы сократить размер ответа, убрали некоторые поля (name, opf, management, address.data). Получить все поля для конкретной компании по-прежнему можно через метод Организация по ИНН.

Обновленный метод доступен только пользователям тарифа «Максимальный» и «коробки».

Пожалуйста! Если будут вопросы — дайте знать.

что произойдёт, если кончатся запросы, установленные в соответствии с тарифом (выбросится исключение или просто метод будет выдавать пустой лист)?

Получите ответ с http-кодом 403.

Через API статистики:

>>> from dadata import DadataAsync

>>> token = "Replace with Dadata API key"
>>> secret = "Replace with Dadata secret key"
>>> await dadata.get_daily_stats()
{
    'date': '2020-07-27',
    'services': {
        'merging': 0,
        'suggestions': 45521,
        'clean': 1200
    }
}

Доли учредителей

В «подсказках» и API компаний появились доли учредителей. Пригодятся для определения конечных бенефициаров, скоринга контрагентов и автогенерации договоров:

Доли возвращаются на тарифе «Максимальный» в полях data.founders[ ].share. Доля может быть выражена в процентах, десятичной или обычной дроби:

# Процент
"share": {
    "value": 50.5,
    "type": "PERCENT"
}

# Десятичная дробь
"share": {
    "value": 0.5,
    "type": "DECIMAL"
}

# Обычная дробь
"share": {
    "numerator": 10,
    "denominator": 11,
    "type": "FRACTION"
}

Поле share будет пустым, если налоговая не сообщила размер доли или вместо относительного размера вернула номинальную стоимость в рублях. Доли, выраженные через номинальную стоимость, поддержим до конца лета.

Сервис поддержки клиентов работает на платформе UserEcho