curl --request GET \
--url https://gdeltcloud.com/api/v2/gleif/entities/{lei} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/gleif/entities/{lei}"
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/{lei}', 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",
"relationships": [],
"reporting_exceptions": [],
"isins": []
},
"meta": {
"attributions": [
{
"source": "GLEIF",
"license": "CC0"
}
]
}
}One GLEIF entity, with its relationships and ISINs
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.
curl --request GET \
--url https://gdeltcloud.com/api/v2/gleif/entities/{lei} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/gleif/entities/{lei}"
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/{lei}', 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",
"relationships": [],
"reporting_exceptions": [],
"isins": []
},
"meta": {
"attributions": [
{
"source": "GLEIF",
"license": "CC0"
}
]
}
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
A 20-character LEI passing the ISO 17442 check digit.