Find your data.
Choose your endpoint.
Start with a data family, then inspect the records and filters. Open a working tool in API Arena when you’re ready to try a request.
4 endpoints matching “/gleif/” across all data families
Events & news
Discover developments, grouped reporting and the evidence behind them.
GDELT article stream · GDELT Cloud classificationPeople & organizations
Find identities and connect their reporting, hierarchy and public roles.
Resolved identities · GLEIF legal entitiesGETOne GLEIF entity, with its relationships and ISINs/api/v2/gleif/entities/{lei}
The full Level-1 record for a single LEI plus its Level-2 relationships, any declared reporting exceptions, and its LEI↔ISIN mappings. A structurally impossible LEI returns 400 INVALID_LEI (it fails the ISO 17442 check digit); a well-formed LEI we do not hold returns 404. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF's required non-endorsement notice.
Response: success, data, meta
Parameters and accepted values (1)
- lei
- A 20-character LEI passing the ISO 17442 check digit.
GETGLEIF legal entities (Open Feed)/api/v2/gleif/entities
The GLEIF Global LEI Index — 3.39M legal entities with their registered name, jurisdiction, entity and registration status, legal form and registration authority, served close to as-published. **At least one filter is required**: the feed covers 3.39M records, so an unfiltered listing is refused with 400 FILTER_REQUIRED rather than served slowly. name matches the normalized legal name exactly or by prefix (never a substring scan). Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF's required non-endorsement notice.
Response: success, data, pagination, applied_filters, meta
Parameters and accepted values (9)
- lei
- One or more LEIs, comma-separated (max 100). Each must pass the ISO 17442 check digit.
- name
- Legal name — normalized-exact or prefix match. Not a substring search.
- country
- ISO-3 country of the legal address (our house convention). Full value list: https://docs.gdeltcloud.com/reference/enums#country
- jurisdiction
- GLEIF's raw legal jurisdiction — alpha-2 or subdivision (US-CA). Observed vocabulary, measured 2026-08-10 (307 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/gleif/entities?country=<iso3>&limit=1 — read legal_jurisdiction. GLEIF's legal jurisdiction as published — ISO 3166-1 alpha-2 plus alpha-2/subdivision forms such as US-CA. Uppercased but NOT validated by the serve layer, unlike the three GLEIF status enums beside it, so an unlisted jurisdiction returns an empty 200. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#gleif_jurisdiction
- entity_status
- Entity status. Validated against the allowed set; a bad value returns 400 INVALID_ENUM with details.accepted_values. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_entity_status
Accepted values: ACTIVE, INACTIVE, NULL
- registration_status
- LEI registration status — e.g. ISSUED, LAPSED, RETIRED. A LAPSED registration does NOT mean the company ceased to exist. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_registration_status
Accepted values: ISSUED, LAPSED, PENDING_TRANSFER, PENDING_ARCHIVAL, DUPLICATE, RETIRED, ANNULLED, CANCELLED, TRANSFERRED, PENDING_VALIDATION, PUBLISHED, MERGED
- entity_category
- GLEIF entity category — e.g. GENERAL, FUND, BRANCH, SOLE_PROPRIETOR. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_entity_category
Accepted values: GENERAL, BRANCH, FUND, SOLE_PROPRIETOR, RESIDENT_GOVERNMENT_ENTITY, INTERNATIONAL_ORGANIZATION
- limit
- Rows to return.
- cursor
- Offset cursor; echo pagination.next_cursor to page.
GETLEI ↔ ISIN mappings/api/v2/gleif/isin
Resolve an LEI to its issued ISINs, or an ISIN back to its LEI. One of lei or isin is required — the mapping table holds ~9M rows and an unfiltered listing is refused with 400 FILTER_REQUIRED. Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF's required non-endorsement notice.
Response: success, data, pagination, applied_filters, meta
Parameters and accepted values (4)
- lei
- LEI to resolve to ISINs.
- isin
- ISIN to resolve back to its LEI.
- limit
- Rows to return.
- cursor
- Offset cursor.
GETGLEIF Level-2 relationships/api/v2/gleif/relationships
Parent/child relationship records as filed with the Global LEI System. lei matches EITHER endpoint. Note the direction convention in the source data: the start node is the CHILD and the end node is the PARENT. Corporate hierarchy as reported to the Global LEI System: accounting consolidation under IFRS/US-GAAP, not percentage ownership and not beneficial ownership. Natural persons are out of scope, and reporting is partial — an absent parent usually means the filer declared a reporting exception rather than that none exists. Plan-gated: requires the can_use_gleif entitlement (Analyst plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Source: GLEIF Golden Copy, published under CC0 1.0. Every response carries meta.attributions[] with GLEIF's required non-endorsement notice.
Response: success, data, pagination, applied_filters, meta
Parameters and accepted values (5)
- lei
- Match relationships where this LEI is either endpoint. Must pass the ISO 17442 check digit.
- relationship_type
- e.g. IS_DIRECTLY_CONSOLIDATED_BY, IS_ULTIMATELY_CONSOLIDATED_BY, IS_INTERNATIONAL_BRANCH_OF. Validated — 400 INVALID_ENUM otherwise. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_relationship_type
Accepted values: IS_DIRECTLY_CONSOLIDATED_BY, IS_ULTIMATELY_CONSOLIDATED_BY, IS_INTERNATIONAL_BRANCH_OF, IS_FUND-MANAGED_BY, IS_SUBFUND_OF, IS_FEEDER_TO
- relationship_status
- ACTIVE or INACTIVE. Observed vocabulary, measured 2026-08-10 (3 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/gleif/relationships?lei=<lei> — read status. The status of a GLEIF relationship record. Unlike relationship_type beside it, this one is uppercased and passed through unvalidated, so it is published as measured. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#gleif_relationship_status
- limit
- Rows to return.
- cursor
- Offset cursor.
Company filings
Retrieve registrants, financial facts and filing-backed business relationships.
SEC EDGAR · XBRLInfrastructure & maritime
Explore sites, energy assets, ports and vessel activity.
Global Energy Monitor · NGA World Port Index · maritime recordsEconomics & country risk
Add dated economic observations, geography and country intelligence.
FRED / ALFRED · World Bank · country indicatorsGovernment & public records
Inspect official lists, political offices and government relationships.
Original publishers · OpenSanctions crawler codeAI & compute
Research models, hardware, data centers and the organizations building them.
Epoch AIMonitors & API tools
Inspect saved monitoring workflows and the API’s supported values and costs.
GDELT CloudUNDERSTAND THE SOURCE
Where the data comes from.
Retrieve SEC filer identity, filing records and evidence-backed company relationships through GDELT Cloud. Connect US registrants to reporting with resolved entity identifiers.
Read the source guideFRED ↗Use FRED and ALFRED economic series through GDELT Cloud’s macro API. Inspect metadata, dated observations, source attribution and redistribution limits.
Read the source guideGlobal Energy Monitor ↗Explore Global Energy Monitor facilities through a structured API. Filter by country or proximity, inspect capacity and registry dates, and connect reporting to infrastructure carefully.
Read the source guideSanctions & public records ↗Inspect original-publisher sanctions and public-record sources through GDELT Cloud. Understand list coverage, entity connections and how MIT-licensed OpenSanctions crawler code is used.
Read the source guide