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:
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
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