Duaer

Get started

Legal entities (LEI) in Duaer

In Duaer: Look up companies worldwide in the GLEIF register: legal name, 20-character LEI, jurisdiction, registered city and country, and entity and registration status. One successful search uses 1 credit.

What you get

Duaer Legal entities searches the Global LEI Index by GLEIF. An LEI identifies one legal entity in financial reporting, so it helps tell apart companies with similar names.

Pick Duaer Data → Legal entities (LEI) in the node creator, or open the data market. Related: SEC filings, ror.

When to use it

  • Confirm the exact legal name and country of a counterparty or supplier.
  • Find the LEI to join company records across systems.

When not to use it

  • Filings and financial reports. Use SEC filings.
  • Ownership trees or beneficial owners. This search returns the entity record only.

Search on the canvas

  1. Open the node creator and pick Duaer Data → Legal entities (LEI).
  2. Fill Words (such as Tencent). Optional: LEI, Country.
  3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

  • GET https://api.duaer.com/v1/data/lei?words=Tencent&country=CN
  • Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-lei
description: >-
  Duaer Legal entities (LEI). Look up companies worldwide in the GLEIF register: legal name, 20-character LEI, jurisdiction, registered city and country, and entity and registration status.
  One successful search uses 1 Duaer credit.
---

# Duaer Legal entities (LEI)

Duaer Legal entities searches the Global LEI Index by GLEIF. An LEI identifies one legal entity in financial reporting, so it helps tell apart companies with similar names.

## When to use

- Confirm the exact legal name and country of a counterparty or supplier.
- Find the LEI to join company records across systems.

## When not to use

- Filings and financial reports. Use https://skills.duaer.com/sec-filings.md.
- Ownership trees or beneficial owners. This search returns the entity record only.

## Call

`GET https://api.duaer.com/v1/data/lei?words=Tencent&country=CN`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `words` or `lei`.

- `words` — Company name or words in it, such as Tencent.
- `lei` — Optional. A 20-character LEI to open one record.
- `country` — Optional. Two-letter ISO code of the legal address, such as CN.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/lei?words=Tencent&country=CN` — Tencent entities with a legal address in China.
- `GET https://api.duaer.com/v1/data/lei?lei=254900R2298R0IPO6I46` — one record by LEI.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `lei`, `legalName` — identifier and legal name.
- `jurisdiction`, `city`, `country` — where the entity is registered.
- `entityStatus`, `category` — ACTIVE or INACTIVE, and entity category.
- `registrationStatus`, `nextRenewal` — LEI status such as ISSUED or LAPSED, and renewal date.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/sec-filings.md — Duaer SEC filings
- https://skills.duaer.com/ror.md

Questions

How many credits does a Legal entities (LEI) search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

What does LAPSED mean in Duaer LEI results?

The entity did not renew its LEI on time. The company may still exist; the LEI data may be out of date.

In this section