curl --request GET \
--url https://gdeltcloud.com/api/v2/gleif/entities \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/gleif/entities"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/gleif/entities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"lei": "5493001KJTIIGC8Y1R12",
"legal_name": "Example Holdings plc",
"jurisdiction": "GB"
}
],
"pagination": {
"limit": 25,
"next_cursor": null
},
"applied_filters": {
"search": "Example Holdings"
},
"meta": {
"attributions": [
{
"source": "GLEIF",
"license": "CC0"
}
]
}
}GLEIF legal entities (Open Feed)
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.
curl --request GET \
--url https://gdeltcloud.com/api/v2/gleif/entities \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/gleif/entities"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://gdeltcloud.com/api/v2/gleif/entities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"lei": "5493001KJTIIGC8Y1R12",
"legal_name": "Example Holdings plc",
"jurisdiction": "GB"
}
],
"pagination": {
"limit": 25,
"next_cursor": null
},
"applied_filters": {
"search": "Example Holdings"
},
"meta": {
"attributions": [
{
"source": "GLEIF",
"license": "CC0"
}
]
}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
One or more LEIs, comma-separated (max 100). Each must pass the ISO 17442 check digit.
Legal name — normalized-exact or prefix match. Not a substring search.
ISO-3 country of the legal address (our house convention). Full value list: https://docs.gdeltcloud.com/reference/enums#country
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 — readlegal_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. 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
ACTIVE, INACTIVE, NULL 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
ISSUED, LAPSED, PENDING_TRANSFER, PENDING_ARCHIVAL, DUPLICATE, RETIRED, ANNULLED, CANCELLED, TRANSFERRED, PENDING_VALIDATION, PUBLISHED, MERGED GLEIF entity category — e.g. GENERAL, FUND, BRANCH, SOLE_PROPRIETOR. Full value list: https://docs.gdeltcloud.com/reference/enums#gleif_entity_category
GENERAL, BRANCH, FUND, SOLE_PROPRIETOR, RESIDENT_GOVERNMENT_ENTITY, INTERNATIONAL_ORGANIZATION Rows to return.
1 <= x <= 500Offset cursor; echo pagination.next_cursor to page.
x >= 0Response
Matching LEI records with pagination, applied_filters and meta.attributions[].
Show child attributes
Show child attributes
Numeric continuation offset; copy next_cursor into the next request cursor. Null ends this page walk.
Show child attributes
Show child attributes
Source attribution, coverage and evidence interpretation; unknown coverage is not zero.