Corporate ownership chain for an LEI (GLEIF Level-2) API

Resolves the LIVE corporate-ownership graph for a Legal Entity Identifier via GLEIF's Level-2 relationship API: the entity itself, its direct parent, its ultimate (group-head) parent, and a bounded sample of direct subsidiaries with the full child count, plus a derived position-in-tree classification. Answers 'who owns this LEI', 'what is the ultimate parent of this company', 'how many subsidiaries does this entity have'. Distinct from a plain LEI lookup, which returns only the single entity.

Price$0.01per request

MethodPOST

Route/v1/ref/gleif-ownership

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

refgleifleikybownershipparentsubsidiarycorporate-structurecompliance

API URLhttps://x402.hexl.dev/v1/ref/gleif-ownership

Integration docs

Example request

{
  "lei": "549300B56MD0ZC402L06",
  "childrenLimit": 2
}

Example response

{
  "lei": "549300B56MD0ZC402L06",
  "entity": {
    "lei": "549300B56MD0ZC402L06",
    "name": "Bloomberg L.P.",
    "jurisdiction": "US-DE",
    "category": "GENERAL",
    "entityStatus": "ACTIVE",
    "registrationStatus": "ISSUED",
    "country": "US",
    "city": "Wilmington"
  },
  "directParent": {
    "lei": "549300RMUDWPHCUQNE66",
    "name": "Bloomberg Inc.",
    "jurisdiction": "US-DE",
    "category": "GENERAL",
    "entityStatus": "ACTIVE",
    "registrationStatus": "ISSUED",
    "country": "US",
    "city": "Wilmington"
  },
  "ultimateParent": {
    "lei": "549300RMUDWPHCUQNE66",
    "name": "Bloomberg Inc.",
    "jurisdiction": "US-DE",
    "category": "GENERAL",
    "entityStatus": "ACTIVE",
    "registrationStatus": "ISSUED",
    "country": "US",
    "city": "Wilmington"
  },
  "directChildren": [
    {
      "lei": "254900X9Q5KAPT8KFM69",
      "name": "BLOOMBERG BETA OPPORTUNITIES 2022 L.P.",
      "jurisdiction": "US-DE",
      "category": "GENERAL",
      "entityStatus": "ACTIVE",
      "registrationStatus": "ISSUED",
      "country": "US",
      "city": "WILMINGTON"
    },
    {
      "lei": "254900PNPB5L5VNJNS35",
      "name": "BLOOMBERG BETA 2016 L.P.",
      "jurisdiction": "US-DE",
      "category": "GENERAL",
      "entityStatus": "ACTIVE",
      "registrationStatus": "ISSUED",
      "country": "US",
      "city": "WILMINGTON"
    }
  ],
  "directChildrenTotal": 27,
  "directChildrenShown": 2,
  "position": "intermediate parent",
  "note": "GLEIF reports only accounting-consolidation parents; absence of a parent means none was reported, not that the entity is independent."
}

Input schema

{
  "type": "object",
  "required": [
    "lei"
  ],
  "properties": {
    "lei": {
      "type": "string",
      "description": "20-character Legal Entity Identifier."
    },
    "childrenLimit": {
      "type": "integer",
      "minimum": 0,
      "maximum": 25,
      "default": 5,
      "description": "Max direct subsidiaries to return (0-25)."
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}