Поиск юридического лица по LEI
Определяет юридическое лицо в реестре GLEIF по коду LEI или по названию. Официальное наименование, адреса, юрисдикция, национальный регистрационный номер, коды BIC и связи с материнскими и дочерними компаниями.
Нет API-ключа?
Войдите в аккаунт, чтобы создавать и управлять API-ключами.
Руководство по интеграции
Скопируйте сниппет, подставьте свой API-ключ, запустите. Работает в любом HTTP-клиенте — примеры ниже на cURL, JavaScript и Python.
/api/lei-lookuphttps://www.apipick.comResolve a legal entity through the GLEIF LEI register
leistringнеобязательный20-character LEI code. Mutually exclusive with name. HWUPKR0MPOU8FGXBT394
namestringнеобязательныйLegal entity name to search for. Mutually exclusive with lei. Tesla, Inc.
countrystringнеобязательныйISO 3166-1 alpha-2 code narrowing a name search. US
include_relationshipsbooleanнеобязательныйWith lei, also return direct parent, ultimate parent, and subsidiary count. true
curl -X GET "https://www.apipick.com/api/lei-lookup" \
-H "x-api-key: YOUR_API_KEY"{
"mode": "lei",
"query": "HWUPKR0MPOU8FGXBT394",
"found": true,
"record": {
"lei": "HWUPKR0MPOU8FGXBT394",
"legal_name": "Apple Inc.",
"other_names": [
"Apple Computer, Inc."
],
"legal_address": {
"lines": [
"C/O C T Corporation System",
"330 N. Brand Blvd"
],
"city": "Glendale",
"region": "US-CA",
"country": "US",
"postal_code": "91203"
},
"jurisdiction": "US-CA",
"legal_form": "H1UM",
"entity_status": "ACTIVE",
"registered_as": "806592",
"bic": [
"APLEUS66XXX"
],
"registration_status": "ISSUED",
"next_renewal_date": "2027-03-08T17:27:20Z"
},
"relationships": {
"direct_parent": null,
"ultimate_parent": null,
"direct_children_count": 8
},
"source": "GLEIF",
"credits_used": 3,
"remaining_credits": 97
}Создано для реальных сценариев
Идентификация юридических лиц
Превратите разнобой в названиях компаний в CRM в единый канонический идентификатор, который аккуратно связывает данные между системами и юрисдикциями.
KYC контрагентов
Сверьте с официальным источником зарегистрированное наименование, юрисдикцию и национальный регистрационный номер контрагента.
Карта владения
Пройдите по связям материнских и дочерних компаний, чтобы понять, кто в конечном счёте контролирует юридическое лицо, прежде чем выдавать кредит или подписывать договор.
Исследовательские агенты
Дайте исследовательскому агенту источник, на который можно сослаться, чтобы утверждения о юридических лицах восходили к реестру, а не к догадке.
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| mode | string | Какой запрос был выполнен: lei или search |
| record.lei | string | 20-символьный идентификатор по ISO 17442 |
| record.legal_name | string | null | Официальное зарегистрированное наименование |
| record.other_names | string[] | Прежние и альтернативные названия по данным реестра |
| record.legal_address | object | null | Юридический адрес, разбитый на строки, город, регион, страну и индекс |
| record.jurisdiction | string | null | Юрисдикция учреждения, например US-CA |
| record.registered_as | string | null | Номер в национальном реестре компаний — мостик к местной отчётности |
| record.entity_status | string | null | ACTIVE или INACTIVE |
| record.bic | string[] | Сопоставленные коды SWIFT/BIC, если они есть у лица |
| record.registration_status | string | null | Статус жизненного цикла LEI, например ISSUED или LAPSED |
| relationships | object | Присутствует при include_relationships: прямая и конечная материнские компании и число дочерних |
| total_matches | integer | Только в режиме поиска: сколько записей совпало с названием |
| credits_used | integer | Кредитов списано за этот запрос |
| remaining_credits | integer | Кредитов осталось на вашем аккаунте |
Лимиты запросов
Ограничение действует на API-ключ, скользящее окно 60 секунд. При превышении вы получаете чистый 429 с заголовком Retry-After.
30req/min
На API-ключ, на эндпоинт. Скользящее окно 60 секунд.
3concurrent
Максимум одновременных активных запросов на API-ключ.
X-RateLimit-LimitМаксимум запросов в минутуX-RateLimit-RemainingОсталось запросов в текущем окнеX-RateLimit-ResetСекунд до сброса текущего окнаRetry-AfterСколько секунд ждать перед повтором (только при 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Источник данных и лицензия
Записи поступают от GLEIF — Global Legal Entity Identifier Foundation, которая ведёт реестр LEI по поручению Regulatory Oversight Committee. GLEIF публикует и справочные данные уровня 1, и данные о владении уровня 2 под CC0: общественное достояние, без обязательной атрибуции и без ограничений на дальнейшее использование.
Часто задаваемые вопросы
В: Что такое LEI и почему его удобно использовать как ключ?
О: Legal Entity Identifier — это 20-символьный код по ISO 17442, который однозначно идентифицирует юридическое лицо во всём мире; он обязателен для всех, кто торгует на регулируемых финансовых рынках. В отличие от названия компании он не допускает разночтений, а в отличие от национального регистрационного номера не пересекается между юрисдикциями, поэтому это правильный ключ связывания.
В: Можно ли искать, не зная LEI?
О: Да. Передайте name вместо lei, чтобы искать в реестре по наименованию, при желании сузив выборку через country. Фильтр GLEIF по названию — это совпадение по релевантности, а не точное, поэтому total_matches может быть большим: возвращаются записи из начала этого ранжирования.
В: Как получить структуру группы?
О: Добавьте include_relationships=true к запросу по LEI. Вы получите прямую материнскую компанию, конечную материнскую компанию и количество прямых дочерних, причём каждая материнская компания указана со своим LEI, так что дерево можно обходить вверх и вниз последующими вызовами.
В: Насколько свежие данные?
О: GLEIF ежедневно публикует новую эталонную копию реестра, а этот эндпоинт обращается к их живому API, а не к локальному снимку. Юридические лица обязаны продлевать LEI ежегодно, поэтому registration_status и next_renewal_date показывают, поддерживается запись в актуальном состоянии или просрочена.
В: Можно ли свободно распространять эти данные?
О: GLEIF публикует справочные данные LEI под CC0, передавая их в общественное достояние без каких-либо лицензионных ограничений на дальнейшее использование. Для данных о юридических лицах это редкость и именно поэтому существует данный эндпоинт: тот же запрос у коммерческого поставщика обычно сопровождается условиями распространения.