Get Energy Owner
curl --request GET \
--url https://gdeltcloud.com/api/v2/energy/owners/{entity_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/energy/owners/{entity_id}"
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/{entity_id}', 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_summary": {
"asset_count": 3,
"capacity_mw_total": 5000,
"by_tracker": [
{
"tracker": "oil_gas_plants",
"asset_count": 1,
"capacity_mw_total": 5000,
"operating_count": 0,
"planned_count": 1,
"inactive_count": 0
}
]
},
"portfolio_url": "/api/v2/energy/assets?owner_entity_id=E100002021513",
"detail_url": "/api/v2/energy/owners/E100002021513"
}
}{
"error": "API key required. Include: Authorization: Bearer gdelt_sk_...",
"code": "MISSING_API_KEY"
}{
"success": false,
"error": "Ownership-exposure context requires a plan with Risk Context access.",
"code": "PLAN_REQUIRED"
}{
"success": false,
"error": "Owner not found.",
"code": "NOT_FOUND"
}{
"success": false,
"error": "Failed to fetch energy owner.",
"code": "INTERNAL_ERROR"
}Energy
Get Energy Owner
Fetch one Global Energy Monitor ownership entity by GEM Entity ID, including parent IDs, external IDs, and a portfolio summary across Energy assets. Optional include_exposure=true adds plan-gated risk/exposure fields — requires can_use_exposure (see Pricing for the plans that include it).
GET
/
api
/
v2
/
energy
/
owners
/
{entity_id}
Get Energy Owner
curl --request GET \
--url https://gdeltcloud.com/api/v2/energy/owners/{entity_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/energy/owners/{entity_id}"
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/{entity_id}', 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_summary": {
"asset_count": 3,
"capacity_mw_total": 5000,
"by_tracker": [
{
"tracker": "oil_gas_plants",
"asset_count": 1,
"capacity_mw_total": 5000,
"operating_count": 0,
"planned_count": 1,
"inactive_count": 0
}
]
},
"portfolio_url": "/api/v2/energy/assets?owner_entity_id=E100002021513",
"detail_url": "/api/v2/energy/owners/E100002021513"
}
}{
"error": "API key required. Include: Authorization: Bearer gdelt_sk_...",
"code": "MISSING_API_KEY"
}{
"success": false,
"error": "Ownership-exposure context requires a plan with Risk Context access.",
"code": "PLAN_REQUIRED"
}{
"success": false,
"error": "Owner not found.",
"code": "NOT_FOUND"
}{
"success": false,
"error": "Failed to fetch energy owner.",
"code": "INTERNAL_ERROR"
}Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
GEM ownership entity ID.
Query Parameters
Include admin-gated exposure_summary from the internal risk/exposure preview.
⌘I

