How do I get the LEI record of a company, with its parent companies?

Call GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/company/lei?lei=HWUPKR0MPOU8FGXBT394 for $0.005. By lei= it returns the entity's legal name, status, legal form, addresses, registration and renewal dates, its direct and ultimate parent as reported to GLEIF, and SWIFT BICs mapped to the LEI; by name= (and country=) it returns the best ten matches to pick from. A parent is only what the entity reported: the field says either a parent (its LEI and name), none reported, or an exception with its reason. A bad LEI or an unknown one is refused before any charge.

Data as of 2026-10-25 · Source: GLEIF Global LEI Index; SWIFT BIC-to-LEI mapping (via GLEIF)

Copy-paste request

GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/company/lei?lei=HWUPKR0MPOU8FGXBT394   # $0.005 per call
curl -i "https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/company/lei?lei=HWUPKR0MPOU8FGXBT394"

The first call without payment answers HTTP 402 with the exact price and the payment requirements; pay and retry with an x402 or MPP client (see /integrations). Runnable examples: /integrations.

The numbers

Example answer: entity: Apple Inc. (HWUPKR0MPOU8FGXBT394); ACTIVE; US-CA
Example answer: registration: ISSUED; next renewal 2027-03-08
Example answer: direct parent: reporting_exception (NATURAL_PERSONS)
Example answer: ultimate parent: reporting_exception (NATURAL_PERSONS)

Query parameters

Parameter	Needed	Meaning
lei	lei or name	20-character Legal Entity Identifier
name	lei or name	company name, 2-100 characters; returns up to 10 ranked matches
country	optional	ISO country of the legal address to narrow a name search, e.g. DE

Example answer

Recorded example answer of /company/lei: the example published in the route's own definition, not a live call. Its dates are the dates of that recording.

{
  "mode": "lei",
  "as_of": "2026-10-25T09:20:00.000Z",
  "source": "GLEIF Global LEI Index",
  "source_url": "https://search.gleif.org/",
  "attribution": "LEI reference data: GLEIF (Global Legal Entity Identifier Foundation), api.gleif.org, CC0 1.0. This service is not provided, supported or endorsed by GLEIF or any LOU.",
  "golden_copy_date": "2026-10-25",
  "lei": "HWUPKR0MPOU8FGXBT394",
  "legal_name": "Apple Inc.",
  "other_names": [
    {
      "name": "Apple Computer, Inc.",
      "type": "PREVIOUS_LEGAL_NAME"
    }
  ],
  "entity_status": "ACTIVE",
  "category": "GENERAL",
  "legal_form_code": "H1UM",
  "legal_form_other": null,
  "jurisdiction": "US-CA",
  "registration_authority_id": "RA000598",
  "registered_as": "806592",
  "creation_date": "1977-01-03",
  "legal_address": {
    "lines": [
      "C/O C T Corporation System",
      "330 N. Brand Blvd",
      "Suite 700"
    ],
    "city": "Glendale",
    "region": "US-CA",
    "country": "US",
    "postal_code": "91203"
  },
  "headquarters_address": {
    "lines": [
      "One Apple Park Way"
    ],
    "city": "Cupertino",
    "region": "US-CA",
    "country": "US",
    "postal_code": "95014"
  },
  "registration": {
    "status": "ISSUED",
    "initial_registration_date": "2012-06-06",
    "last_update_date": "2026-03-03",
    "next_renewal_date": "2027-03-08",
    "managing_lou": "5493001KJTIIGC8Y1R12",
    "corroboration_level": "FULLY_CORROBORATED"
  },
  "successor_entities": [],
  "bic": [
    "APLEUS66XXX"
  ],
  "bic_notice": "SWIFT (c) and database rights. All rights reserved. This Mapping Table has been developed by SWIFT. Any use of the Mapping Table, in whole or in part, is subject to the BIC/LEI Mapping Table License Agreement as published with the Mapping Table available on GLEIF's website. The Mapping Table is updated monthly. For the latest BIC information and updates, always refer to www.swift.com/bic.",
  "direct_parent": {
    "relationship": "reporting_exception",
    "reason": "NATURAL_PERSONS",
    "lei": null,
    "legal_name": null,
    "country": null
  },
  "ultimate_parent": {
    "relationship": "reporting_exception",
    "reason": "NATURAL_PERSONS",
    "lei": null,
    "legal_name": null,
    "country": null
  },
  "note": "Registry data exactly as GLEIF publishes it; legal_form_code is the ISO 20275 ELF code. Parents are the relationships reported to GLEIF (reporting_exception = the entity reported why none is given). Not legal advice or a credit check.",
  "cached": false
}

The full answer

/company/lei - $0.005 per call: LEI record with parent companies: the exact route this page describes
/check/counterparty - $0.015 per call: sanctions screening, the LEI record and US bank status in one call

Paid routes answer HTTP 402 with the payment requirements until paid over x402 or MPP (no account or key); see how to pay, pay without a client, OpenAPI. The figures on this page are also at ?format=json.

How this was measured

Parents are the relationships reported to GLEIF; an entity can report an exception (for example that it has no consolidating parent, or that the parent is a natural person) instead of naming one, and the field then shows that reason, as the recorded example does.
The record is shown exactly as GLEIF publishes it; legal_form_code is the ISO 20275 code. GLEIF's data are published under CC0 1.0; this service is not provided, supported or endorsed by GLEIF or any LOU.
The BIC mapping is SWIFT's own table with its own licence notice, which is returned with every answer that holds a BIC.
Not legal, financial or security advice; P0 is not affiliated with or endorsed by any of the publishers named here.
GLEIF Global LEI Index: LEI reference data: GLEIF (Global Legal Entity Identifier Foundation), api.gleif.org, CC0 1.0. This service is not provided, supported or endorsed by GLEIF or any LOU.
SWIFT BIC-to-LEI mapping (via GLEIF): SWIFT (c) and database rights; its licence notice is returned with every answer that holds a BIC.