curl --request GET \
--url https://gdeltcloud.com/api/v2/energy/owners \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/energy/owners"
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/energy/owners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"entity_id": "E100002021513",
"full_name": "Pacifico Energy Group LLC",
"name": "Pacifico Energy Group LLC",
"abbreviation": null,
"entity_type": "company",
"legal_entity_type": "company",
"publicly_listed": false,
"registration_country_iso3": "USA",
"headquarters_country_iso3": "USA",
"gem_parent_ids": [],
"external_ids": {},
"portfolio_url": "/api/v2/energy/assets?owner_entity_id=E100002021513",
"detail_url": "/api/v2/energy/owners/E100002021513"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null
}
}{
"error": "API key required. Include: Authorization: Bearer gdelt_sk_...",
"code": "MISSING_API_KEY"
}{
"success": false,
"error": "Failed to fetch energy owners.",
"code": "INTERNAL_ERROR"
}Search Energy Owners
Search the Global Energy Monitor ownership registry for canonical owner entities. Use this endpoint to resolve a company, government owner, person, or investment vehicle to a GEM Entity ID before calling owner portfolio or exposure endpoints.
curl --request GET \
--url https://gdeltcloud.com/api/v2/energy/owners \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/energy/owners"
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/energy/owners', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"entity_id": "E100002021513",
"full_name": "Pacifico Energy Group LLC",
"name": "Pacifico Energy Group LLC",
"abbreviation": null,
"entity_type": "company",
"legal_entity_type": "company",
"publicly_listed": false,
"registration_country_iso3": "USA",
"headquarters_country_iso3": "USA",
"gem_parent_ids": [],
"external_ids": {},
"portfolio_url": "/api/v2/energy/assets?owner_entity_id=E100002021513",
"detail_url": "/api/v2/energy/owners/E100002021513"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null
}
}{
"error": "API key required. Include: Authorization: Bearer gdelt_sk_...",
"code": "MISSING_API_KEY"
}{
"success": false,
"error": "Failed to fetch energy owners.",
"code": "INTERNAL_ERROR"
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Query Parameters
Search owner name, abbreviation, GEM Entity ID, or external ID.
Alias for q.
Exact GEM ownership entity ID.
Country filter — matches an owner's registration or headquarters country. Accepts a country name, ISO-2, or ISO-3 via the shared resolveCountryInput layer (combinable with region/continent); an unresolvable value returns 400 INVALID_COUNTRY.
Region expanded to ISO-3 countries; matches registration or headquarters country.
Middle East, Northern Africa, Western Africa, Eastern Africa, Middle Africa, Southern Africa, Eastern Europe, South Asia, Southeast Asia, East Asia, Central Asia, Northern America, Central America, Caribbean Continent expanded to ISO-3 countries; matches registration or headquarters country.
Africa, Asia, Europe, North America, South America, Oceania Comma-separated GEM owner entity types. Observed vocabulary, measured 2026-08-10 (6 distinct values). Values outside it are accepted, not rejected. Discover current values: GET /api/v2/energy/owners?limit=1 — readentity_type``. The corporate-registry classification GEM assigns an ownership entity. Unvalidated at the serve layer — /api/v2/energy/owners?entity_type= is applied as a plain IN list, so an unlisted value returns an empty 200. Values seen in the corpus: https://docs.gdeltcloud.com/reference/enums#gem_owner_entity_type
Filter by public-listing status.
Rows per page.
1 <= x <= 100Pagination cursor from pagination.next_cursor.

