Skip to main content
GET
Search Energy Owners

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

q
string

Search owner name, abbreviation, GEM Entity ID, or external ID.

Alias for q.

entity_id
string

Exact GEM ownership entity ID.

country
string

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
enum<string>

Region expanded to ISO-3 countries; matches registration or headquarters country.

Available options:
Africa,
Asia,
Middle East,
Northern Africa,
Western Africa,
Eastern Africa,
Middle Africa,
Southern Africa,
Europe,
Eastern Europe,
South Asia,
Southeast Asia,
East Asia,
Central Asia,
North America,
Central America,
Caribbean,
South America,
Oceania
continent
enum<string>

Continent expanded to ISO-3 countries; matches registration or headquarters country.

Available options:
Africa,
Asia,
Europe,
North America,
South America,
Oceania
entity_type
string

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

publicly_listed
boolean

Filter by public-listing status.

limit
integer
default:25

Rows per page.

Required range: 1 <= x <= 100
cursor
string

Pagination cursor from pagination.next_cursor.

Response

Success

success
enum<boolean>
required
Available options:
true
data
object[]
required
pagination
object
required
applied_filters
object