Documentation Python quickstart Blog Free tools Enterprise solutions hello@quanticdata.ioLog in
All collectors

LEI API

Finance & crypto · v1.1.0 · gleif_lei

$0.0004 / entity

$0.40 / 1K · pay per delivered entity

An LEI API searches GLEIF, the public register of Legal Entity Identifiers, by legal name — or looks up an exact LEI — and returns one row per entity: the LEI itself, the legal name, the entity and registration status, the legal and headquarters country and city, the legal form and the registration dates. The LEI is the global identifier that joins a company across financial datasets, and here it comes back keyless.

$0.0004 per delivered entity · $2 free every month · Failed runs never billed

What it does

What a LEI API does

A company appears under a slightly different name in every dataset, which is exactly what makes cross-source joins fail. The LEI is the fix: a single twenty-character code every regulated entity is issued, stable where names are not. Search a name here to resolve it to that code, and you hold the key that lines the same firm up across filings, ownership and price data.

Pass a legal name to search GLEIF's register, or pass a twenty-character LEI to pull that exact entity. Either way the row carries both the entity status and the LEI registration status — active versus lapsed, issued versus retired — so a reference table can tell a live identifier from a stale one at a glance.

Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

InputTypeRequiredWhat it does
querystringyesLegal name to search, or an exact 20-char LEI.
countrystringnoLimit to entities whose legal address is in this country (ISO 3166-1 alpha-2).
max_resultsintegernoHow many entities to deliver at most (1–100). You pay only for delivered entities.

Outputs — 29 fields, one row per entity

What one entity looks like

Every delivered entity carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

FieldTypeWhat it holds
rankinteger1-based position.
leistringLegal Entity Identifier.
legal_namestring · nullableLegal name.
statusstring · nullableEntity status (ACTIVE…).
registration_statusstring · nullableLEI registration status (ISSUED, LAPSED…).
legal_countrystring · nullableLegal address country.
legal_citystring · nullableLegal address city.
hq_countrystring · nullableHeadquarters country.
legal_formstring · nullableLegal form code.
initial_registrationstring · nullableFirst LEI registration date.
last_updatestring · nullableLast update date.
urlstringGLEIF record URL.
other_namesstring[]Trading, previous and transliterated names.
legal_regionstring · nullableRegion of the legal address (ISO 3166-2).
legal_postal_codestring · nullablePostal code of the legal address.
legal_addressstring · nullableLegal address on one line.
hq_citystring · nullableHeadquarters city.
hq_addressstring · nullableHeadquarters address on one line.
jurisdictionstring · nullableJurisdiction of formation.
legal_form_otherstring · nullableLegal form in words, when it has no ELF code.
categorystring · nullableEntity category (GENERAL, FUND, BRANCH…).
registered_asstring · nullableNational business-register number the LEI was validated against.
registration_authoritystring · nullableRegister that issued registered_as (GLEIF RA code).
entity_createdstring · nullableDate the legal entity was formed.
next_renewalstring · nullableNext LEI renewal date.
managing_loustring · nullableLEI of the issuing organisation.
corroboration_levelstring · nullableHow far the record was corroborated against the register.
bicstring[]BIC codes mapped to the entity.
conformity_flagstring · nullableGLEIF conformity flag.

Integration

One POST, typed rows

Base URL https://api.quanticdata.io/v1, Bearer auth, the same key as every other Data API. Endpoint: POST /v1/scraper/collectors/gleif_lei/run.

curl -X POST https://api.quanticdata.io/v1/scraper/collectors/gleif_lei/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Apple Inc","max_results":10}'

Example response

POST /v1/scraper/collectors/gleif_lei/run
$ curl $QD/gleif_lei/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"query": "Apple Inc", "max_results": 10}'
{ "status": "done", "count": 10,
  "results": [
    {
      "lei": "…",
      "legal_name": "…",
      "status": "…",
      "registration_status": "…" } ],
  "cost": 0.004 }
# 10 entities × $0.0004 · nothing delivered, nothing charged

Try it

Legal Entity Identifier (GLEIF), running now

Change the input and run it against the live collector — nothing to install, no sign-up.

Run it from your own code, on your own inputs

Same collector, same rows — $2 of free API credit every month, no card.

Get my free API key
LEI API: from query, QuanticData reads the LEI record and returns one row per entity with legal_name, lei and registration_status, at $0.0004 per delivered entity.
You send query and max_results; the run reads the source and comes back as entities with rank, lei and legal_name — 29 fields on every row — and you are billed $0.0004 for each entity actually delivered, nothing for a run that delivers none.
$0.0004 / entity5,000 entities on the free $2 every month
Semantic inputquery, max_results — no URL lists
Up to 100entities per run, pagination handled for you
No browserread over HTTP/TLS — cheaper and faster than rendering

Pricing

LEI API pricing

$0.0004 per delivered entity. A run that delivers nothing costs nothing: blocked pages, challenges and retries are on us, and the $2 monthly allowance covers about 5,000 entities before you spend anything.

$0.0004per delivered entity$0.4 per 1,000 delivered entities
5,000 entitieson the free allowance$2 every month, no card
Zero rowszero chargeblocks, captchas and retries are on us
−30%on volume tiersthe catalog returns your key's price

Same wallet, same key and same $2 monthly allowance as every other Data API. Prices are launch pricing read live from the billing config — GET /v1/scraper/collectors returns the price your key actually pays.

What people build with the LEI API

Three shapes of work this endpoint was designed around.

Entity resolution

Search a messy company name and resolve it to its LEI, the stable key that deduplicates the same firm across every source you hold.

Counterparty reference data

Look up an LEI and get the legal name, country and legal form as a row — the reference record a KYC or onboarding table is built around.

Registration monitoring

The registration status field flags LEIs that have lapsed, so a portfolio of identifiers can be checked for the ones due to be renewed.

LEI API versus rolling your own

The differences that actually cost time when you build this in-house.

DIY scraperThis collector
Cross-dataset joinMatch companies by fuzzy nameResolve to the LEI, a stable global key
QueryOne lookup style onlySearch by name or look up an exact LEI
CurrencyAssume the identifier is still validEntity and registration status on every row

What people search for

Live autocomplete demand around Legal Entity Identifier (GLEIF), pulled with our own Keyword ideas collector.

LEI API: the POST to the gleif_lei collector, 10 entities delivered and the bill, 10 × $0.0004 = $0.004 in usage.cost_usd; zero entities would cost $0.
The same call you would paste into a terminal: a Bearer key, query in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many entities arrived and usage.cost_usd is $0.004, which is 10 × $0.0004. A run that delivers nothing costs nothing. The key is good for 60 req/min on the free tier.

Sources and standards

The platform documentation and standards this collector is built against — check any claim on this page against the primary source:

FAQ

Questions we get about the LEI API.

Something else? Ask us

What is an LEI and why join on it?

The Legal Entity Identifier is a twenty-character code issued to a legal entity and recognised across financial datasets. Because it is stable where company names are not, resolving a name to its LEI gives you a reliable key to join the same firm across sources.

Can I look up a company by name, not just by LEI code?

Yes. Pass a legal name and GLEIF is searched for matching entities; pass a twenty-character LEI and that exact record is returned. Both modes come back in the same row shape.

How do I tell an active LEI from a lapsed one?

Every row carries status for the entity and registration_status for the LEI — ISSUED, LAPSED and so on — so a set of identifiers can be filtered down to the ones still current.

Is there a free LEI API?

Every account gets $2 of credit every month with no card, which is about 5,000 delivered entities on this endpoint at $0.0004 each. It renews monthly, and a run that delivers nothing is never billed — so a failed or blocked attempt does not eat the allowance.

How much does one run cost?

Multiply the rows you actually receive by $0.0004. A run capped at 100 entities — the maximum for this collector — costs $0.04 if every row comes back, and less when the source has fewer. Volume tiers take up to 30% off, and GET /v1/scraper/collectors returns the price your key actually pays.

Run the LEI API now

$2 of free credit every month, no card. Your key returns its own prices from GET /v1/scraper/collectors.

Run in dashboard
Illustration: three coloured zones of the page that is read (LEI record) turn into clean JSON with the fields legal_name, lei and registration_status; 29 fields on every row.