Skip to main content
Every filter value the API understands, generated from the same objects the server validates against. This page cannot describe a value the API does not accept, or omit one it does.

How to read this page

Values come in three kinds, and the difference decides what you can safely build on. Mixing them up is not a documentation nicety — it is the difference between a filter that is exhaustive and one that quietly is not. Live, machine-readable version of this whole page, including a sha256 you can pin against: GET /api/v2/meta/enums. It is unmetered — checking a value before you spend a query unit on a request that would fail should not itself cost a query unit.

Closed vocabularies

activity-time-basis

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
published · recorded Accepted by: time_basis On: /api/v2/activity · /api/v2/countries · /api/v2/countries/{iso3}

activity-kind

Closed vocabulary — 8 values. Use these. A few earlier spellings are still accepted so existing requests keep working, but they are not listed. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The record types the feed carries. Events and Stories are not in it today: keep a copy of them by re-reading recent dates (https://docs.gdeltcloud.com/data/as-of-and-latency#keep-a-copy-in-sync). entity · facility · list_entry · office_holder · filing · entity_relationship · facility_observation · facility_relationship Accepted by: kind On: /api/v2/activity

activity-change

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
added · updated · removed Accepted by: change On: /api/v2/activity

monitor-query-endpoint

Closed vocabulary — 4 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
/api/v2/events · /api/v2/stories · /api/v2/activity · /api/v2/situations/{story_id}/editions Accepted by: subject.endpoint On: /api/v2/monitors · /api/v2/monitors/preview

monitor-run-view

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
full · summary Accepted by: view On: /api/v2/monitors/{id}/runs · /api/v2/monitors/{id}/runs/{runId}

country_basis

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
publication · reporting Accepted by: basis On: /api/v2/countries · /api/v2/countries/{iso3}

country_directory_sort

Closed vocabulary — 5 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
recent · name · events · stories · rising Accepted by: sort On: /api/v2/countries

country_include

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
gpr · posture · fundamentals Accepted by: include On: /api/v2/countries

target_type

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_TARGET_SCOPE, and the error carries details.accepted_values so a caller can self-correct without reading this page.
entity · facility Accepted by: target_type On: /api/v2/activity · /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary · /api/v2/entities
Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_TARGET_SCOPE, and the error carries details.accepted_values so a caller can self-correct without reading this page.
direct · connected Accepted by: related_scope On: /api/v2/activity · /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary · /api/v2/entities

region

Closed vocabulary — 14 values. Use these. A few earlier spellings are still accepted so existing requests keep working, but they are not listed. Anything else is rejected with 400 INVALID_REGION, and the error carries details.accepted_values so a caller can self-correct without reading this page.
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 Accepted by: region On: /api/v2/resources/statistics · /api/v2/countries · /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary · /api/v2/facilities · /api/v2/filings/relations · /api/v2/search · /api/v2/entities

continent

Closed vocabulary — 6 values. This is the authoritative set. Anything else is rejected with 400 INVALID_CONTINENT, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Africa · Asia · Europe · North America · South America · Oceania Accepted by: continent On: /api/v2/resources/statistics · /api/v2/countries · /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary · /api/v2/facilities · /api/v2/filings/relations · /api/v2/search · /api/v2/entities

event_category

Closed vocabulary — 17 values. This is the authoritative set. Anything else is rejected with 400 INVALID_CATEGORY, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The union of the ACLED event types (Conflict family) and the CAMEO+ domains, all listed here. The family is implied by the category, which is why event_family is deprecated. Battles · Protests · Riots · Explosions/Remote violence · Violence against civilians · Strategic developments · POLITICAL · CRIME · ECONOMIC · CORPORATE · TECHNOLOGY · INFRASTRUCTURE · ENVIRONMENT · HEALTH · DEMOGRAPHIC · INFORMATION · GOVERNANCE Accepted by: category, event_category On: /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary · /api/v2/situations · /api/v2/entities

story_category

Closed vocabulary — 22 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Two spellings of ONE vocabulary. The cameoplus_* / conflict_security forms are what the story layer stores and what a response echoes back; the bare CAMEO+ domain forms (CORPORATE, CONFLICT, …) are what the event taxonomy and the published examples use. Send either — they resolve to the same filter. /api/v2/share-of-voice?category= takes the identical set. conflict_security · cameoplus_political · cameoplus_crime · cameoplus_economic · cameoplus_corporate · cameoplus_technology · cameoplus_infrastructure · cameoplus_environment · cameoplus_health · cameoplus_demographic · cameoplus_information · CONFLICT · CORPORATE · CRIME · DEMOGRAPHIC · ECONOMIC · ENVIRONMENT · HEALTH · INFORMATION · INFRASTRUCTURE · POLITICAL · TECHNOLOGY Accepted by: story_category On: /api/v2/stories · /api/v2/stories/summary

event_family

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
conflict · cameoplus Accepted by: event_family On: /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/entities

cameoplus_domain

Closed vocabulary — 11 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
POLITICAL · CRIME · ECONOMIC · CORPORATE · TECHNOLOGY · INFRASTRUCTURE · ENVIRONMENT · HEALTH · DEMOGRAPHIC · INFORMATION · GOVERNANCE Accepted by: domain On: /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary · /api/v2/entities

entity_family

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Which canonical ids the handle stands for. expand follows the arbiter’s stored merge decisions only — it never widens on a name, an alias or an acronym, so it cannot pull in a different real-world entity that happens to be spelled similarly. Accepted by: entity_family On: /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary

entity_sort

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
significance · recent · rising Accepted by: sort On: /api/v2/entities

event_sort

Closed vocabulary — 5 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
significance · recent · prominence · spread · rising Accepted by: sort On: /api/v2/events

story_sort

Closed vocabulary — 4 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
significance · recent · spread · rising Accepted by: sort On: /api/v2/stories

event_group_by

Closed vocabulary — 8 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The bucket key /api/v2/events/summary groups by. source_actor_country and target_actor_country bucket by actor ORIGIN — which country the acting or receiving side represents — rather than by where the event happened, which is what country does. /api/v2/stories/summary spells group_by over a SHORTER list (a Story has no actors of its own); other surfaces have their own dimensions and are not this list. date · country · region · continent · category · subcategory · source_actor_country · target_actor_country Accepted by: group_by On: /api/v2/events/summary

story_group_by

Closed vocabulary — 6 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The bucket key /api/v2/stories/summary groups by. Deliberately shorter than the Events list: a Story carries no source/target actor, only an undirected set of its linked events’ actor origins, so it cannot bucket by acting versus receiving side. date · country · region · continent · category · subcategory Accepted by: group_by On: /api/v2/stories/summary

story_country_attribution

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
primary · all Accepted by: country_attribution On: /api/v2/stories/summary

country_match

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Which definition of “in this country” the country, region and continent filters apply. The default is deliberately the wide one — a French company sanctioned in Washington is a French story — so a caller who never sets it keeps the answer they have always had. Measured on 2026-08-12, a country=United States event summary returned 13.7% of its events located outside the United States under the default; country_match=location is how you exclude them. The value in force is echoed back as applied_filters.country_match whether or not you sent it. A Story has no coordinates of its own. Under the default it matches when a linked Event matches OR, when country is the only Event-scoped filter, when the Story’s own country attribution names the country. location reads linked-Event coordinates only, so it implies has_events=true: a Story with no coded Event never matches it, however plainly it is set in the country. Most served Stories carry no coded Event (about 80% of list-served Stories over 2026-10-15..21), so for country coverage of Stories keep the default. Accepted by: country_match On: /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary · /api/v2/entities

entity_match

Closed vocabulary — 1 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Entity matching uses coverage: the entity appears in or is linked to a Story, and Events qualify through those Stories. Omitted entity_match and coverage have the same behavior. This is mention/linkage evidence, not proof that the entity acted in or was materially involved in an Event. Accepted by: entity_match On: /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary

entity_type

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Stored and published here in upper case, but MATCHED CASE-INSENSITIVELY — parseEntityTypes lowercases the input, and the endpoint’s own 400 message tells you to send lower case. Both work. This list is the value space, not the required spelling. PERSON · ORGANIZATION · PLACE Accepted by: type On: /api/v2/entities

facility_type

Closed vocabulary — 29 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
coal_plant · oil_gas_plant · nuclear_plant · geothermal_plant · bioenergy_plant · hydropower_plant · solar_farm · wind_farm · coal_mine · oil_gas_field · iron_ore_mine · coal_terminal · lng_terminal · gas_pipeline · oil_pipeline · lng_carrier · port · steel_plant · cement_plant · chemical_plant · data_center · mineral_mine · concentrator · smelter · mineral_refinery · smelter_refinery · mineral_processing_plant · recycling_plant · manufacturing_factory Accepted by: type On: /api/v2/facilities

facility_class

Closed vocabulary — 8 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
power · extraction · transport_logistics · ports · heavy_industry · digital_infrastructure · mineral_processing · manufacturing Accepted by: class On: /api/v2/facilities

resource_statistic_source

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
usgs_mcs · usgs_myb Accepted by: source On: /api/v2/resources/statistics

resource_statistic_scope

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
country · aggregate · unresolved Accepted by: scope On: /api/v2/resources/statistics

facility_sort

Closed vocabulary — 8 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
name · capacity_desc · capacity_asc · recent · country · news_activity · relevance · rising Accepted by: sort On: /api/v2/facilities

facility_claim_status

Closed vocabulary — 4 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
reported · probable · verified · unresolved Accepted by: claim_status On: /api/v2/facilities/{facility_id}/relationships

facility_name_search_mode

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
lexical · fuzzy Accepted by: search_mode On: /api/v2/facilities

facility_source_silo

Closed vocabulary — 8 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
gem · maritime_ports · epoch · usgs_domestic · usgs_myb · climate_trace · compute_atlas · eea_industrial Accepted by: source On: /api/v2/facilities

facility_context_include

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
gov · nearby Accepted by: include On: /api/v2/facilities/{facility_id}/context

situation_include

Closed vocabulary — 1 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Unlike the other include vocabularies, this one is subtractive: the block is OMITTED unless asked for. totals.edge_count is always returned so a caller can decide whether the second call is worth making. edges Accepted by: include On: /api/v2/situations/{story_id}

situation_sort

Closed vocabulary — 9 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Every value is a stored column on the Situation row, except span_days, which is the inclusive day count between span.start and span.end, and relevance, which ranks a search by its own matches and needs search, and rising, which ranks by member Stories in the last two days against the seven before. Ties break on situation_uid ascending in every order, so paging with offset is stable across requests. article_count · story_count · event_count · recent · created · updated · span_days · relevance · rising Accepted by: sort On: /api/v2/situations

office_scope

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Level of government the office belongs to, derived from the source’s gov.national / gov.state / gov.muni / gov.igo topics. An office with no scope topic at all is served as national — sources tag scope inconsistently, and subnational / international are the claims that need positive evidence. Matched case-insensitively. national · subnational · international Accepted by: scope On: /api/v2/offices

office_branch

Closed vocabulary — 8 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Branch of government, derived from the gov.* topics. head wins over executive when both are present (a head of government is also an executive; the more specific claim is the one a filter wants). other is a real, sendable value: an office whose topics name no recognised branch is served under it rather than dropped, so branch=other is how to find the residue. Accepted under the alias topic. Matched case-insensitively. legislative · executive · head · judicial · security · financial · igo · other Accepted by: branch On: /api/v2/offices

office_holder_status

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Whether a holder still occupies the office, AS THE PUBLISHER ASSERTS IT — independent of the dates. unknown is NOT current: it means the source did not say, and it is served as-is rather than coerced from a missing end_date. To ask “who held it on a date” use as_of, which reads the published start/end dates and ignores this flag. Matched case-insensitively. current · ended · unknown Accepted by: status On: /api/v2/offices/{office_id}/holders · /api/v2/entities/{entity_id}/offices

offices_sort

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
name (A–Z, the default) · holders_desc (most office-holders on record first) · country (ISO-3, then name). The cursor a page mints is bound to the sort it was minted under, so changing sort mid-walk answers 400 CURSOR_STALE rather than a plausible wrong page. name · holders_desc · country Accepted by: sort On: /api/v2/offices

chokepoint

Closed vocabulary — 11 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
A curated set of maritime chokepoints, each defined by a bounding box that the AIS ingest subscribes to — so a position is TAGGED with one of these at write time and the warehouse can never hold a value outside the list. Open water carries an empty tag and is excluded from transits. Adding one is a code change plus new ingest coverage, not a data change. hormuz · bab_el_mandeb · malacca · suez · panama · bosphorus · gibraltar · dover · kerch · taiwan · danish_straits Accepted by: chokepoint On: /api/v2/maritime/transits · /api/v2/maritime/vessels · /api/v2/maritime/dwell · /api/v2/maritime/gaps · /api/v2/maritime/chokepoint-watch

min_harbor_size

Closed vocabulary — 4 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
A MINIMUM, not an exact match — medium returns medium and large. The API spelling is ours; the World Port Index column it ranks is Titlecase (Very Small…Large). A fifth WPI size would rank 0 and become unreachable, so this list is only closed for as long as WPI’s is. very_small · small · medium · large Accepted by: min_harbor_size On: /api/v2/maritime/ports

maritime_dwell_status

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Whether a dwell episode had ended at the rollup edge. Two failure modes worth knowing: a VALID value can return 409 STATUS_UNAVAILABLE while the port_dwell status-column rebuild is pending (the rows then carry status: null), and rows written before that rebuild carry the column default — an empty string that is not in this vocabulary. ongoing · completed Accepted by: status On: /api/v2/maritime/dwell

gem_tracker

Closed vocabulary — 15 values. This is the authoritative set. Anything else is rejected with 400 INVALID_TRACKER, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The fifteen Global Energy Monitor registries behind gem.assets_view. Genuinely closed — a tracker exists only when a loader and a table exist for it. Three sharp edges: the same code returns 400 on /energy/assets and 404 on the /energy/assets/{tracker}/{gem_id} path param; the four Heavy-Industry trackers are a SEPARATE vocabulary accepted only on /energy/assets and /energy/assets/summary; and capacity units are NOT a function of the tracker — see gem_capacity_unit. Accepted by: tracker On: /api/v2/energy/assets · /api/v2/energy/assets/summary · /api/v2/energy/assets/{tracker}/{gem_id}

gem_heavy_industry_tracker

Closed vocabulary — 4 values. This is the authoritative set. Anything else is rejected with 400 UNSUPPORTED_FILTER, and the error carries details.accepted_values so a caller can self-correct without reading this page.
GEM’s Materials program, kept out of gem_tracker because these report capacity in ttpa / mtpa rather than MW and cannot share a rollup with the energy trackers. Accepted ONE AT A TIME, never mixed with an energy tracker, and never with fuel or tier — each of those is a 400 UNSUPPORTED_FILTER. They are also reachable only through the tracker spelling: the trackers alias routes to the energy lane and 400s INVALID_TRACKER. iron_steel_plants · cement_plants · chemical_plants · iron_ore_mines Accepted by: tracker On: /api/v2/energy/assets · /api/v2/energy/assets/summary

energy_status

Closed vocabulary — 24 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Seven lifecycle FAMILIES plus every member spelling they expand to — sending a family name matches all of its members. Matched case-insensitively. This is a hand-maintained partition over a column GEM owns, so it is closed only until GEM ships a status nobody has mapped: the sibling vocabulary on /api/v2/facilities (facility_status) reads the same class of data and is published as a measurement for exactly that reason. operating · construction · proposed · permitted · cancelled · mothballed · retired · active · underground gas storage · on order · mixed status · announced · pre-construction · pre-permit · in-development · discovered · exploration · shelved · cancelled - inferred 4 y · shelved - inferred 2 y · abandoned · idle · idled · decommissioning Accepted by: status On: /api/v2/energy/assets · /api/v2/energy/assets/summary

energy_fuel

Closed vocabulary — 9 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Fuel CATEGORIES, each expanding to a set of synonyms found in the source data. Not accepted on a Heavy-Industry request — that combination is a 400 UNSUPPORTED_FILTER. gas · oil · bioenergy · coal · solar · wind · nuclear · hydropower · geothermal Accepted by: fuel On: /api/v2/energy/assets · /api/v2/energy/assets/summary

energy_sort

Closed vocabulary — 6 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The sort orders /api/v2/energy/assets accepts. The Events and Stories lists take their own sort values, published separately, because each endpoint rejects the other’s. capacity_desc · capacity_asc · start_year_desc · start_year_asc · recent · name Accepted by: sort On: /api/v2/energy/assets

energy_asset_class

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Fixed assets (plants, mines, pipelines) versus mobile ones (LNG carriers). Defaults to fixed, and flips to all on its own when the request asks for lng_carriers alone — so the effective default is not always the declared one. fixed · mobile · all Accepted by: asset_class On: /api/v2/energy/assets · /api/v2/energy/assets/summary

energy_group_by

Closed vocabulary — 8 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Bucket dimension for the energy summary. Two further spellings — start_year and decade — are intercepted before this enum is consulted and therefore work without appearing here; a Heavy-Industry request accepts a different, smaller set. country · region · continent · tracker · status · start_year_decade · fuel · tier Accepted by: group_by On: /api/v2/energy/assets/summary

filings_sort

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
recent · filer Accepted by: sort On: /api/v2/filings

filings_summary_group_by

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Also the discovery path for form_type, which is an open vocabulary — see sec_form_type. form_type · date · filer Accepted by: group_by On: /api/v2/filings/summary

filings_event_type

Closed vocabulary — 12 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The 8-K material-event kinds. Genuinely closed because it is the CLOSED OUTPUT VOCABULARY of our own extractor, with other as the residual — the column can only ever hold what the extractor was allowed to emit. Case-sensitive. material_agreement · executive_change · results · acquisition · disposition · guidance · restructuring · impairment · delisting · bankruptcy · cyber_incident · other Accepted by: event_type On: /api/v2/filings/events

filings_rel_type

Closed vocabulary — 7 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Counterparty relation kinds extracted from filing text. Closed for the same reason as filings_event_type: it is the extractor’s own output vocabulary. Note risk_factor is a first-class member — two hand-written doc pages list only six of these seven and drop it. subsidiary · supplier · customer · counterparty · partner · jurisdiction_exposure · risk_factor Accepted by: rel_type On: /api/v2/filings/relations

filings_relation_match

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
resolved admits a relation bound to the entity by its stored registry id, or by the table’s own consensus for that exact object name — what /filings/{cik}/relations reports for the same row. name also admits a relation whose unresolved object name equals one of the entity’s registry names and no other registry entity’s; those rows are labelled name_match. resolved · name Accepted by: match On: /api/v2/filings/relations

filings_relation_group_by

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
relation returns one row per stored relation; filer one row per filer and relation kind, carrying its most recent evidence. relation · filer Accepted by: group_by On: /api/v2/filings/relations

filings_relation_resolution_source

Closed vocabulary — 4 values. A response field: every value it carries is one of these.
How a relation’s object was tied to a registry entity: ingest (the id stored at extraction), serve_consensus (the table’s own majority id for that exact object name), name_match (an unambiguous registry-name match, opt-in) or unresolved. ingest · serve_consensus · name_match · unresolved

macro_frequency

Closed vocabulary — 10 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
BOTH spellings of each cadence are accepted — the word (prefix-matched against FRED’s messy frequency string, so Weekly reaches “Weekly, Ending Friday”) and the short code (exact against frequency_short). Case-insensitive. Two published tellings each got this half right: the spec declared the codes only, the 400 advertises the words only. Annual/A is legal and currently matches no series. Daily · D · Weekly · W · Monthly · M · Quarterly · Q · Annual · A Accepted by: frequency On: /api/v2/macro/series

macro_seasonal_adjustment

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Matched case-insensitively. ★ This is a FRED vocabulary that we nonetheless REJECT on, measured across fewer than a hundred series — so the day ALFRED emits a fourth adjustment string, this 400s a value the warehouse holds. Closed here because that is the behaviour today; the fix is to stop rejecting, which is a contract change of its own. Not Seasonally Adjusted · Seasonally Adjusted · Seasonally Adjusted Annual Rate Accepted by: seasonal_adjustment On: /api/v2/macro/series

macro_agency

Closed vocabulary — 11 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
DERIVED from the featured-series catalogue rather than hand-listed, so it cannot fall below what the catalogue actually serves. Case-insensitive. BEA · BLS · CBOE · Census · DOL · EIA · FHFA · FRB · Freddie Mac · Treasury · U. Michigan Accepted by: agency On: /api/v2/macro/series · /api/v2/macro/releases

list_change_type

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Emitted by our own list differ, so the column cannot hold anything else. Case-sensitive. added · removed · changed Accepted by: change_type On: /api/v2/lists/changes

list_entries_sort

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
name · recent Accepted by: sort On: /api/v2/lists/entries

list_category

Closed vocabulary — 8 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
What KIND of restricted-party list a catalogue source is — the non-PEP buckets of the OSINT catalogue. Read from ref.list_catalog.category for crawler-lane sources and from the static legacy map for the hand-loaded ones. Only sanctions and export_control memberships count toward the sanctions exposure lens; a debarment or wanted-person listing is catalogued and screenable but is NOT a sanction. Case-insensitive. Accepted by: category On: /api/v2/lists

exposure_lens

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The three exposure classifications the spine computes. Declared beside the INGEST that writes the column, so the reader and the writer cannot disagree. sanctions · china · state_owned Accepted by: lens On: /api/v2/exposure

exposure_subject

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Whether the answer is about assets or about entities. The DECLARED default is assets, but the OBSERVED default is not: with an entity handle and no asset selector the endpoint silently switches to entities and says so in subject_note. Worth sending explicitly. On the entities path, group_by and sort are accepted, ignored, and echoed back as applied. assets · entities Accepted by: subject On: /api/v2/exposure

exposure_group_by

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Validated only on the assets path — see exposure_subject. none · country · tracker Accepted by: group_by On: /api/v2/exposure

exposure_sort

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Validated only on the assets path — see exposure_subject. capacity_desc · stake_desc Accepted by: sort On: /api/v2/exposure

atlas_level

Closed vocabulary — 4 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Geographic aggregation level. Shared by GPR, Posture and Coverage — but the DEFAULT is not: Posture defaults to country. world · continent · region · country Accepted by: level On: /api/v2/intelligence/gpr · /api/v2/intelligence/posture

atlas_posture_scope

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Which posture blocks to return. Omitting the param is NOT the same as sending all: absent returns both the internal and external blocks in their own right. all · internal · external Accepted by: scope On: /api/v2/intelligence/posture

atlas_posture_window

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
★ Posture’s window is a TOKEN, not a number of days — 30d, not 30. It is the only window in the v2 surface that works this way (GPR’s is a strict integer from 1 through 30), and a bare integer here is a 400 INVALID_ENUM. 7d · 30d Accepted by: window On: /api/v2/intelligence/posture

atlas_weighting

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Corpus weighting. On Posture, gdp can silently DEGRADE to attention when the GDP basis is unavailable — the response says which was actually used in weighting.effective plus a reason. attention · gdp Accepted by: weighting On: /api/v2/intelligence/gpr · /api/v2/intelligence/posture

atlas_gpr_construction

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Which denominator the index is normalized against: our own coverage, or the world corpus. Not interchangeable — two series built on different constructions must never be compared. own_coverage · world_corpus Accepted by: construction On: /api/v2/intelligence/gpr

atlas_gpr_variant

Closed vocabulary — 4 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The two GPR lenses are events and attention. fullspectrum and gpr are the internal storage names, still accepted as legacy aliases — they are published here because the server accepts them, while the 400 deliberately advertises only the two product names. events · attention · fullspectrum · gpr Accepted by: variant On: /api/v2/intelligence/gpr

atlas_gpr_component

Closed vocabulary — 5 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Which decomposition of the index to return. Membership in this list is NECESSARY BUT NOT SUFFICIENT — see the per-variant sets below; sending a component the variant does not carry is a 400 INVALID_ENUM whose accepted_values is that variant’s set, not this union. all · threats · acts · verbal · material
The legal values depend on variant. The list above is the union across every variant; membership in it does NOT mean a value is accepted with the variant you are sending. A mismatch returns 400 INVALID_ENUM whose details.accepted_values is the row below, not the union.
The events lens (and its fullspectrum storage alias) carries all five; the gpr lens is built from the threat/act partition only, so verbal and material do not exist for it; the attention lens is a single undecomposed series, so all is its only component. Measured against prod: 6 of the 15 pairs a flat 5-value enum implies cannot return a row. Accepted by: component On: /api/v2/intelligence/gpr

atlas_gpr_metric

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
gpr is the product name for the index; pulse is its legacy internal alias. gpr · pulse · attention_share Accepted by: metric On: /api/v2/intelligence/gpr

atlas_coverage_tier

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
depth · thin · none Accepted by: tier On: /api/v2/intelligence/coverage

search_universe

Closed vocabulary — 5 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
registry is the raw GLEIF LEI universe in its own lane and additionally requires the GLEIF entitlement — an unentitled caller gets 403 PLAN_REQUIRED, not 400. It is a legal value regardless of plan, which is why it is listed here. osint is the open-source (OSINT) crawl lane’s reference records in its own lane — screening-list entries (os_* source keys, organisations and individuals) and political office holders, including reference-only rows that are never minted into the spine. Gated per sub-source by the Open Feed that sells it: can_use_screening for list entries, can_use_offices for office holders; a caller with neither gets 403 PLAN_REQUIRED, and meta.lanes names any sub-source withheld. A person hit carries only name, aliases, citizenship, Wikidata QID, gender and birth year. all · news · reference · registry · osint Accepted by: universe On: /api/v2/search

search_entity_type

Closed vocabulary — 4 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
★ LOWERCASE, and deliberately a DIFFERENT value-space from entity_type (UPPERCASE), which /api/v2/entities accepts. Same concept, two spellings, two endpoints — registered separately rather than merged, because publishing one casing for both would advertise a value one of them rejects. place is a first-class member on both; a filter that offers only person and organization silently hides every geography. person · organization · place · facility Accepted by: type On: /api/v2/search

search_country_match

Closed vocabulary — 2 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Strict requires known source country association; include_unknown also retains candidates with no country evidence. Omitted preserves compatibility. strict · include_unknown Accepted by: country_match On: /api/v2/search

entity_hierarchy_direction

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Which way to walk the ownership tree from the anchor entity. Defaults to both. up · down · both Accepted by: direction On: /api/v2/entities/{entity_id}/hierarchy

gleif_entity_status

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
From the LEI-CDF specification. NULL is a real, sendable value — GLEIF publishes it as a string for records where the status is genuinely unknown, so it is not the absence of a value. ACTIVE · INACTIVE · NULL Accepted by: entity_status On: /api/v2/gleif/entities

gleif_registration_status

Closed vocabulary — 12 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
The LEI record’s own lifecycle, distinct from whether the legal entity is active. Twelve values, of which MERGED is deprecated upstream and retained for historical records. ISSUED · LAPSED · PENDING_TRANSFER · PENDING_ARCHIVAL · DUPLICATE · RETIRED · ANNULLED · CANCELLED · TRANSFERRED · PENDING_VALIDATION · PUBLISHED · MERGED Accepted by: registration_status On: /api/v2/gleif/entities

gleif_entity_category

Closed vocabulary — 6 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
GENERAL · BRANCH · FUND · SOLE_PROPRIETOR · RESIDENT_GOVERNMENT_ENTITY · INTERNATIONAL_ORGANIZATION Accepted by: entity_category On: /api/v2/gleif/entities

gleif_relationship_type

Closed vocabulary — 6 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
From the RR-CDF specification. Accounting consolidation, branch, and the three fund relationships. Note IS_FUND-MANAGED_BY carries a hyphen inside the token. IS_DIRECTLY_CONSOLIDATED_BY · IS_ULTIMATELY_CONSOLIDATED_BY · IS_INTERNATIONAL_BRANCH_OF · IS_FUND-MANAGED_BY · IS_SUBFUND_OF · IS_FEEDER_TO Accepted by: relationship_type On: /api/v2/gleif/relationships

actor_type

Closed vocabulary — 9 values. A response field: every value it carries is one of these.
The actor classification carried on conflict events as inter1 (the acting side) and inter2 (the receiving side). None applies only to inter2, in a one-sided event with no second actor. None · State forces · Rebel groups · Political militias · Identity militias · Rioters · Protesters · Civilians · External/Other forces

quality

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
How much scoring confidence a row must clear to be returned. production_ready is the default and the one to build on; reviewable widens to rows we would show a human but not a customer; all disables the filter entirely and will include rows we do not stand behind. production_ready · reviewable · all Accepted by: tone_quality On: /api/v2/share-of-voice

geo_precision

Closed vocabulary — 3 values. A response field: every value it carries is one of these.
How exactly the event was located: 1 an exact named place, 2 a nearby or general area (“near X”), 3 only the region, province or country is known. The companion geo_precision_label field carries these as exact_place, nearby_area and country_or_region. This is the difference between an event AT an asset and an event somewhere in the same country — check it before triggering on a coordinate. Filter on it with geo_precision_min and geo_precision_max on /api/v2/events. 1 · 2 · 3

time_precision

Closed vocabulary — 3 values. A response field: every value it carries is one of these.
How exactly the event was dated: 1 the exact day is known, 2 within a week, 3 within a month. There is no time_precision_label field — the number is what is served. A 3 on a daily time series is a month-wide event pinned to one bucket, not a same-day observation. 1 · 2 · 3

actor_role

Closed vocabulary — 4 values. A response field: every value it carries is one of these.
The part an actor played in the event. WHICH PAIR YOU GET IS DECIDED BY family, and the two pairs never mix on one card. CAMEO+ events are DIRECTED and carry source (who acted) and target (who was acted upon) — this is the direction bilateral questions turn on. Conflict (ACLED) events are UNDIRECTED — two parties to a clash — and carry actor1 and actor2, which imply no initiator. actor1/actor2 is not a legacy spelling of source/target: filtering on actor direction cannot return conflict events, because that family does not record one. source · target · actor1 · actor2

incident_resolution

Closed vocabulary — 3 values. This is the authoritative set. Anything else is rejected with 400 INVALID_ENUM, and the error carries details.accepted_values so a caller can self-correct without reading this page.
Whether this event was checked for being a duplicate of another, and what the check found. llm — an independent adversarial judge CONFIRMED a duplicate, and incident.uid names the survivor. self — adjudicated and found unique. unadjudicated — never checked, which is a DIFFERENT claim from self, not a weaker one: “we did not look” is not “we found nothing”. Coverage is partial by design, so filter to llm,self when you need to count incidents rather than rows. unadjudicated · self · llm Accepted by: incident_resolution On: /api/v2/events · /api/v2/events/summary

event_match_type

Closed vocabulary — 3 values. A response field: every value it carries is one of these.
How a row was retrieved by search=, on Event and Story cards. semantic means the row came back from embedding similarity and carries a search_score; name means the search text matched its title or names as whole words, and it carries the search_score of its semantic match when it also had one, otherwise null. entity means the row was added because it is linked to a person or organisation the search text names (the same link entity= filters on, and on the rest of the search text); it also carries search_score: null, and meta.interpretation lists the names read. The field is OMITTED entirely on non-search requests rather than served as null. NOT the same vocabulary as match_type on /api/v2/search. semantic · name · entity

Observed vocabularies

These are measurements. We publish them because guessing is worse, and we date them because an undated measurement is indistinguishable from a promise.

facility_commodity

Observed vocabulary — a measurement, not an allowlist. These are the 116 values present in the corpus as of 2026-10-02. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
Facility commodity memberships are an open vocabulary published by the current source registries. This measured list supplies Arena suggestions only; it is not a request allowlist, and new or unmeasured values remain valid inputs. coal · cement · iron_ore · iron_and_steel · copper · lime · gold · glass · silver · aluminum · raw_steel · zinc · stone_size_and_shape_unspecified · lead · stone_crushed · chemicals · steel_products · ferroalloys · bauxite · pulp_and_paper · manganese · rare_earths · petrochemicals · nickel · gypsum · cobalt · salt · sand_and_gravel_unspecified · sulfur · titanium · molybdenum · sand_and_gravel_construction · nitrogen · direct_reduced_iron · tin · chromium · lithium · platinum · stone_dimension · clays · palladium · uranium · gemstones · sand_and_gravel_industrial · tungsten · graphite · phosphate_rock · barite · kaolin · clinker · talc_and_related_materials · alumina · diamond · bentonite · fertilizers · feldspar · antimony · magnesium · rhodium · silicon · magnesite · fluorspar · tantalum · zirconium · potash · pumice_and_related_materials · ruthenium · peat · iridium · boron · tellurium · phosphate · selenium · zeolites · vanadium · indium · rhenium · iron_oxide_pigments · helium · soda_ash · niobium · niobium_and_tantalum · cadmium · gallium · iodine · bismuth · diatomite · mica · diamond_industrial · pig_iron · germanium · ball_clay · perlite · bromine · coke · kyanite_and_related_materials · wollastonite · asbestos · vermiculite · mercury · garnet · strontium · arsenic · beryllium · fire_clay · scandium · celestite · arsenic_trioxide · abrasives · common_clay · beryl · methanol · quartz · hafnium · osmium · thallium Discover the current set: GET /api/v2/meta/enums (facility_commodity) or inspect facility card commodities Accepted by: commodity On: /api/v2/facilities

resource_commodity

Observed vocabulary — a measurement, not an allowlist. These are the 160 values present in the corpus as of 2026-10-03. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
USGS resource-statistics commodity keys are an open observed vocabulary. Suggestions are measured from the active resource-statistics release and never restrict accepted filters. copper · stone_crushed · cement · lead · gold · iron_ore · ferroalloys · salt · zinc · silver · sulfur · gypsum · sand_and_gravel_industrial · gemstones · sand_and_gravel_construction · raw_steel · manganese · clays · stone_dimension · aluminum · nickel · phosphate_rock · lime · nitrogen · steel_products · tin · cobalt · chromium · fluorspar · feldspar · antimony · stone_size_and_shape_unspecified · kaolin · bauxite · bentonite · tungsten · rare_earths · silicon · peat · potash · titanium · barite · alumina · pig_iron · diatomite · cadmium · zirconium · molybdenum · selenium · tantalum · abrasives_manufactured · soda_ash · vanadium · talc_and_related_materials · lithium · perlite · diamond · bismuth · mica_natural · boron · vermiculite · platinum · iron_and_steel · palladium · titanium_mineral_concentrates · rhenium · pumice_and_related_materials · mica · tellurium · iron_oxide_pigments · magnesium_metal · indium · fertilizers · magnesium_compounds · diamond_industrial · iodine · graphite · graphite_natural · magnesite · direct_reduced_iron · talc_and_pyrophyllite · germanium · titanium_sponge_metal · bromine · helium · nitrogen_fixed_ammonia · niobium · gallium · niobium_columbium · uranium · pumice_and_pumicite · beryllium · strontium · mercury · arsenic · kyanite_and_related_minerals · asbestos · garnet_industrial · zeolites_natural · common_clay · zeolites · clinker · magnesium · feldspar_and_nepheline_syenite · iron_and_steel_scrap · niobium_and_tantalum · fuller_s_earth · tio2_pigment · thallium · thorium · phosphate · granite_only · rhodium · iron_and_steel_slag · yttrium · scandium · hafnium · wollastonite · diamond_bort_grit_and_dust_and_powder_natural_and_synthetic · beryl · diamond_stones_natural_and_synthetic · platinum_group_metals · arsenic_trioxide · industrial_cultured_quartz_crystal · ruthenium · kyanite_and_related_materials · argon · krypton · xenon · neon · celestite · ground_high_purity_quartz · iridium · sand_and_gravel_unspecified · garnet · nepheline_syenite · fire_clay · abrasives · rubidium · cesium · ytterbium · rare_earths_heavy · ball_clay · zirconium_and_hafnium · erbium · holmium · terbium · lutetium · europium · samarium · gadolinium · osmium · praseodymium · cerium · dysprosium · neodymium · neon_krypton_and_xenon · leonardite · lanthanum · quartz_high_purity_and_industrial_cultured_crystal Discover the current set: GET /api/v2/meta/enums (resource_commodity) or inspect resource-statistics results Accepted by: commodity On: /api/v2/resources/statistics

resource_statistic

Observed vocabulary — a measurement, not an allowlist. These are the 16 values present in the corpus as of 2026-10-03. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
USGS statistic labels are an open observed vocabulary; source-native and newly introduced values remain valid filters. production · import · price · export · reserves · import sources 2021-2024 · consumption · net import reliance · employment · capacity · stock · sold or used · shipment · sales · sold · supply Discover the current set: GET /api/v2/meta/enums (resource_statistic) or inspect resource-statistics results Accepted by: statistic On: /api/v2/resources/statistics

sec_form_type

Observed vocabulary — a measurement, not an allowlist. These are the 262 values present in the corpus as of 2026-08-10. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
SEC form types are an open vocabulary: 264 distinct values appeared in a single 30-day window, and 424B2 alone was 36.3% of them. Any closed list here would be wrong within a quarter, so this filter accepts anything and returns an empty result for a form type the window does not contain. 424B2 · 4 · 8-K · 13F-HR · NPORT-P · FWP · D · 10-Q · 144 · SCHEDULE 13G/A · 6-K · N-PX · 497K · SCHEDULE 13G · 3 · D/A · 497 · 424B3 · 485BXT · 10-D · ABS-EE · DEFA14A · 13F-NT · 425 · N-MFP3 · 485BPOS · 497J · 24F-2NT · EFFECT · SCHEDULE 13D/A · N-CSR · S-8 · S-8 POS · 424B5 · 485APOS · DEF 14A · N-CSRS · 4/A · 8-A12B · CERT · ABS-15G · 8-K/A · 497VPU · 25-NSE · S-1/A · 497VPI · 40-17G · ARS · 10-K · S-1 · PRE 14A · S-6 · NPORT-P/A · 13F-HR/A · N-CEN · POS AM · SCHEDULE 13D · 486BPOS · MA-I/A · 487 · SC TO-I/A · C/A · S-3ASR · 1-U · S-3 · C · DFAN14A · 20-F · 424B8 · C-U · SC TO-I · F-1/A · S-4/A · AW · 15-12G · 424B4 · X-17A-5 · 3/A · 6-K/A · 10-D/A · 253G2 · POS EX · 10-K/A · 497AD · DEF 14C · N-23C3A · N-VP/A · F-6EF · 144/A · N-2 · F-1 · N-2/A · 40-APP/A · F-3 · N-PX/A · N-MFP3/A · N-14 · C-AR · S-4 · S-3/A · 40-APP · F-4/A · 1-A POS · NT 20-F · PRE 14C · 10-Q/A · RW · DEFM14A · 424B7 · SC TO-T/A · MA-I · 1-A · S-6/A · NT 10-Q · PREM14A · 5 · APP NTC · 1/A · 25 · QUALIF · 424H · F-X · 40-17F2 · 15-15D · POSASR · IRANNOTICE · N-CSR/A · ABS-15G/A · SC 14D9/A · NT 10-K · F-6 POS · N-23C-2 · 20-F/A · ATS-N/UA · 1-A/A · SEC STAFF ACTION · N-8F · 11-K · 8-K12B · F-3/A · 18-K/A · F-3ASR · APP ORDR · 305B2 · PRER14A · DRS · MA-A · 10-12G/A · SD · F-6 · 10-12G · POS AMI · N-8A · S-1MEF · SBSE-A/A · PX14A6G · DSTRBRPT · N-8F ORDR · N-54A · MA/A · DEFC14A · N-CSRS/A · 40-8B25 · N-14/A · PREC14A · 1-A-W · 8-A12B/A · 10-12B/A · 1-SA · TA-1/A · F-10 · ATS-N/MA · 8-A12G · 18-K · F-4 · N-CEN/A · 40-33 · SUPPL · CB · TA-2 · N-1A/A · F-10EF · 40-6B · 1-K · 40-24B2 · C-W · DEFA14C · SEC STAFF LETTER · 486BXT · SC TO-C · 15-12G/A · F-10/A · NRSRO-UPD · SC 13D/A · N-2ASR · REVOKED · 424B1 · 6B ORDR · NT-NCEN · C-TR · SC 14F1 · DEL AM · S-B/A · 10-12B · N-14 8C · DEFR14A · SC 13E3/A · F-N · SC14D9C · SC 14D9 · DEFM14C · S-11 · 253G1 · N-30B-2 · NT N-CEN · ANNLRPT · SF-3 · N-8F NTC · 40-17F1 · ATS-N/CA · 15F-12B · S-3DPOS · SC TO-T · F-10POS · S-B · 20FR12B/A · N-8F/A · N-1A · 8-K12G3 · APP WD · CFPORTAL/A · 6B NTC · SF-3/A · SD/A · APP WDG · S-4 POS · UPLOAD · 8-K15D5 · DEFR14C · N-54C · 20FR12B · N-6 · DFRN14A · PRRN14A · N-4/A · PREN14A · POS462B · C-TR-W · 40FR12B/A · DRS/A · C/A-W · 40FR12B · S-3D · QRTLYRPT · SC 13E3 · 13F-NT/A · X-17A-5/A · S-11/A · 40-F · N-30D · N-6F/A · SC13E4F Discover the current set: GET /api/v2/filings/summary?group_by=form_type Accepted by: form_type On: /api/v2/filings · /api/v2/filings/summary

facility_status

Observed vocabulary — a measurement, not an allowlist. These are the 32 values present in the corpus as of 2026-08-10. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
GEM lifecycle statuses arrive mixed-case and carry inferred variants (e.g. “shelved - inferred 2 y”), so the served vocabulary is what the registry actually holds rather than a curated list. Matching is case-insensitive. operating · pre-construction · cancelled · announced · construction · retired · Operating · cancelled - inferred 4 y · shelved - inferred 2 y · shelved · proposed · mothballed · active · Proposed · Mothballed · discovered · on order · permitted · pre-permit · in-development · Cancelled · Shelved · idle · Retired · abandoned · decommissioning · idled · operating pre-retirement · underground gas storage · Construction · mixed status · exploration Discover the current set: GET /api/v2/facilities?limit=1 (see applied_filters) or /api/v2/meta/enums Accepted by: status On: /api/v2/facilities

gem_capacity_unit

Observed vocabulary — a measurement, not an allowlist. These are the 37 values present in the corpus as of 2026-08-10. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
The unit of capacity.value on a GEM asset. It is NOT a function of the tracker: for lng_terminals, gas_pipelines, oil_pipelines and lng_carriers the loader passes GEM’s own per-row CapacityUnits string through verbatim, so one tracker returns several units and the casing varies (mtpa and Mtpa are both present). Measured 2026-08-10: lng_terminals carries 10 distinct units across 1,206 rows and gas_pipelines carries 17 across 4,246, of which 1,604 carry no unit at all. NEVER sum capacity.value across rows without grouping by this field; capacity.mw is the only cross-tracker-summable number, and it is populated only for the power trackers. MW · Mtpa · mtpa · bcm/y · cbm · MMcf/d · bpd · Mt · MMSCMD · TJ/d · mill.Sm3/day · bcf/d · GWh/d · m3/day · Mcf/d · scm/y · m3/month · lpy · m3/h · Tn/d · gal/day · GWh/h · tpa · thousand m3/year · Mb/d · m3/year · PJ/y · Dth/d · Tn/day · scm/yr · m3/d · bph · tn/h · BCF/y · MWh/d · Tsd. m³/h · MMBtu/d Discover the current set: GET /api/v2/energy/assets?tracker=<tracker>&limit=1 (read capacity.unit on each row) Accepted by: capacity_unit (response field) On: /api/v2/energy/assets

energy_tier

Observed vocabulary — a measurement, not an allowlist. These are the 5 values present in the corpus as of 2026-08-10. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
GEM’s own coverage tier for an asset row (main sheet vs below-threshold vs closed, and the utility/distributed split on solar). The serve layer accepts it as a free comma list and does not validate it, so an unknown tier returns an empty 200 rather than a 400 — which is why it is published as a measurement rather than as an allowlist. utility · main · below_threshold · closed · sub_threshold Discover the current set: GET /api/v2/energy/assets/summary?group_by=tier Accepted by: tier On: /api/v2/energy/assets

gem_owner_entity_type

Observed vocabulary — a measurement, not an allowlist. These are the 6 values present in the corpus as of 2026-08-10. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
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. legal entity · state · state body · arrangement · unknown entity · person Discover the current set: GET /api/v2/energy/owners?limit=1 (read entity_type) Accepted by: entity_type On: /api/v2/energy/owners

list_cadence

Observed vocabulary — a measurement, not an allowlist. These are the 2 values present in the corpus as of 2026-08-10. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
How often a screening list is refreshed. Read straight off the catalogue and matched CASE-SENSITIVELY with no validation, so cadence=Daily returns zero rows while cadence=daily returns twelve. The sibling jurisdiction filter was made case-insensitive for exactly this reason; cadence was not. daily · episodic Discover the current set: GET /api/v2/lists (read cadence on each catalogue entry) Accepted by: cadence On: /api/v2/lists

gleif_jurisdiction

Observed vocabulary — a measurement, not an allowlist. These are the 250 values present in the corpus as of 2026-08-10 (307 distinct in total; the most frequent are listed). The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
GLEIF’s legal jurisdiction as published — ISO 3166-1 alpha-2 plus alpha-2/subdivision forms such as US-CA. Uppercased but NOT validated by the serve layer, unlike the three GLEIF status enums beside it, so an unlisted jurisdiction returns an empty 200. IN · IT · DE · GB · NL · ES · FR · US-DE · SE · DK · CN · LU · BE · NO · FI · AU · AT · KY · PL · IE · VG · CZ · EE · CH · HU · US · CA · US-CA · JP · PT · US-NY · LI · CY · CA-ON · SG · US-FL · JE · US-TX · HK · TR · US-OH · US-PA · RO · US-MA · GG · US-IL · CA-QC · GR · SK · MX · MT · US-MI · US-NJ · CA-BC · PA · BG · SA · IS · BS · LT · US-GA · SI · AE · US-MD · MU · US-NC · BR · US-WI · US-VA · LV · IM · NZ · BM · US-IN · CA-AB · US-NV · US-WA · ZA · US-CT · US-CO · HR · MH · US-MN · KR · AE-DU · US-TN · GI · US-MO · IL · TH · US-AZ · SC · MY · US-SC · US-OR · RU · TW · US-IA · CL · US-AL · US-LA · ID · BZ · US-KY · US-UT · US-OK · US-WY · US-NE · US-KS · US-NH · CA-MB · CO · CW · LR · NG · MC · US-ME · WS · AR · AE-AZ · US-AR · VC · US-RI · CA-SK · CA-NS · PH · US-DC · US-SD · US-ID · UY · PE · US-MS · KN · US-ND · CA-NB · AD · GB-NIR · PR · FO · US-NM · US-WV · KN-N · US-VT · US-HI · AI · VN · QA · CK · EG · GB-SCT · BB · KZ · US-MT · TC · KE · BH · RS · UA · LB · CR · US-AK · AE-RK · OM · MY-15 · PY · BD · DO · KW · LC · MA · LK · VE · JO · GT · MK · VU · PK · GE · AE-SH · TN · EC · GH · BA · NC · DM · SM · CA-NL · PS · MO · SV · AE-AJ · AG · NA · CA-PE · KM · TT · UG · AL · KG · ZW · HN · AM · AO · PF · TZ · ME · GL · UZ · BW · AZ · ZM · VI · MN · BQ · JM · AW · MD · BY · IQ · XX · BO · CI · XK · AE-UQ · MV · FJ · NP · BN · KH · CD · AE-FU · NI · SN · MZ · GU · RW · YE · UN · SX · SR · CM · DZ · LA · TG · BF · PG · BE-VLG · ML · MR · FK Discover the current set: GET /api/v2/gleif/entities?country=<iso3>&limit=1 (read legal_jurisdiction) Accepted by: jurisdiction On: /api/v2/gleif/entities

gleif_relationship_status

Observed vocabulary — a measurement, not an allowlist. These are the 3 values present in the corpus as of 2026-08-10. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
The status of a GLEIF relationship record. Unlike relationship_type beside it, this one is uppercased and passed through unvalidated, so it is published as measured. ACTIVE · NULL · INACTIVE Discover the current set: GET /api/v2/gleif/relationships?lei=<lei> (read status) Accepted by: relationship_status On: /api/v2/gleif/relationships

fara_country

Observed vocabulary — a measurement, not an allowlist. These are the 250 values present in the corpus as of 2026-08-10 (265 distinct in total; the most frequent are listed). The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
The foreign principal’s country AS FARA SPELLS IT — KOREA, SOUTH, MYANMAR (BURMA), GREAT BRITAIN. The country= filter resolves your input to ISO-3 and then matches every stored spelling that maps to it, so you may send an ISO code or an English name; these are the raw values you will see in a response. JAPAN · CANADA · MEXICO · GREAT BRITAIN · FRANCE · KOREA, SOUTH · GERMANY, FEDERAL REPUBLIC OF · INTERNATIONAL · ISRAEL · USSR · CHINA · SAUDI ARABIA · TAIWAN · RUSSIA · DOMINICAN REPUBLIC · ITALY · NETHERLANDS · SWITZERLAND · TURKEY · AUSTRALIA · VENEZUELA · CUBA · GERMANY · HAITI · UKRAINE · POLAND · SPAIN · BRAZIL · PHILIPPINES · UNITED ARAB EMIRATES · PANAMA · SOUTH AFRICA · NIGERIA · COLOMBIA · SWEDEN · QATAR · ARGENTINA · ROMANIA · JAMAICA · PAKISTAN · INDIA · HONG KONG · IRAQ · INDONESIA · CZECHOSLOVAKIA · AUSTRIA · GUATEMALA · MOROCCO · BELGIUM · THAILAND · NICARAGUA · HUNGARY · BAHAMAS · NORWAY · IRELAND · LIBERIA · EGYPT · GREECE · DENMARK · EL SALVADOR · CHILE · LIBYA · PERU · ANGOLA · BERMUDA · ECUADOR · CONGO, DEMOCRATIC REPUBLIC OF THE · UNITED KINGDOM · CAYMAN ISLANDS · GEORGIA · COSTA RICA · IRAN · CONGO, REPUBLIC OF THE · YUGOSLAVIA · MALAYSIA · BULGARIA · GERMAN DEMOCRATIC REPUBLIC · COTE D'IVOIRE (IVORY COAST) · KAZAKHSTAN · ETHIOPIA · LEBANON · HONDURAS · FINLAND · KUWAIT · AZERBAIJAN · SINGAPORE · PORTUGAL · CYPRUS · BARBADOS · JORDAN · NEW ZEALAND · SOMALI DEMOCRATIC REPUBLIC · NETHERLANDS ANTILLES · AFGHANISTAN · KENYA · ALGERIA · GABON · SCOTLAND · BANGLADESH · SUDAN · VIETNAM · SERBIA · BOLIVIA · TRINIDAD AND TOBAGO · UZBEKISTAN · ALBANIA · SRI LANKA · CAMBODIA · BAHRAIN · ICELAND · BOSNIA & HERZEGOVINA · PALESTINE · MARSHALL ISLANDS · GUYANA · UGANDA · TUNISIA · NORTHERN IRELAND · CAMEROON · GHANA · LUXEMBOURG · CROATIA · ZIMBABWE · CURACAO · TOGO · ARUBA · KOSOVA · ANTIGUA & BARBUDA · ZAIRE · MOZAMBIQUE · GRENADA · YEMEN · SYRIA · ZAMBIA · OMAN · MONGOLIA · SIERRA LEONE · BRITISH VIRGIN ISLANDS · UNITED STATES · SAINT LUCIA · EQUATORIAL GUINEA · LATVIA · MALAWI · SENEGAL · NAMIBIA · MYANMAR (BURMA) · PARAGUAY · RWANDA · LITHUANIA · ARMENIA · TANZANIA · GUINEA · URUGUAY · MOLDOVA · MAURITANIA · DOMINICA · MACEDONIA · LIECHTENSTEIN · ERITREA · BENIN · SURINAME · MONACO · BELIZE · MALTA · ST. KITTS AND NEVIS · TURKS AND CAICOS ISLANDS · SLOVENIA · BELARUS · PALAU · SWAZILAND · PAPUA NEW GUINEA · CZECHIA · SOMALIA · FIJI · BOTSWANA · BURKINA FASO · MONTENEGRO · MAURITIUS · SLOVAKIA · ANGUILLA · KYRGYZSTAN · MALDIVES · BURUNDI · BIAFRA · GAMBIA, THE · BRUNEI · LAOS · MALI · SAINT VINCENT AND THE GRENADINES · BOPHUTHATSWANA · CABO VERDE · MONTSERRAT · SEYCHELLES · SOUTH SUDAN · NIGER · CHAD · TRANSKEI · NAURU · TIBET · TONGA · CEYLON (SRI LANKA) · REPUBLIC OF SOUTH SUDAN · MADAGASCAR · ISLE OF MAN · VIRGIN ISLANDS · PUERTO RICO · MICRONESIA · NEPAL · MACAU · VANUATU · LESOTHO · GUADELOUPE & MARTINIQUE · SOMALILAND · ESTONIA · TAHITI · SOUTH MOLUCCAS, REPUBLIC OF · CENTRAL AFRICAN REPUBLIC · CHANNEL ISLANDS · TAJIKISTAN · KOREA, NORTH · DJIBOUTI · UNKNOWN · ST. EUSTATIUS · TURKMENISTAN · ST. MARTIN · GUINEA-BISSAU · NAGORNO KARABAKH · GUERNSEY · BONAIRE · CISKEI · BURMA · SAHARAWI ARAB DEMOCRATIC REPUBLIC · UNITED STATES, MISCELLANEOUS CARIBBEAN ISLANDS · YEMEN, PEOPLES DEMOCRATIC REPUBLIC OF YEMEN · TIMOR-LESTE (EAST TIMOR) · WEST BERLIN · NEW CALEDONIA · WESTERN SAMOA · NORTH MACEDONIA · SAN MARINO · ENGLAND · DAHOMEY · UNITED KINGDOM OF CORALLAND · CENTRAL AND SOUTHERN LINE ISLANDS · BRITISH SOLOMON ISLANDS · SULU AND NORTH BORNEO · SAO TOME AND PRINCIPE · BRITISH WEST INDIES · VATICAN CITY · SOUTHERN YEMAN · GREENLAND Discover the current set: GET /api/v2/gov/fara?entity=<id> (read country on each foreign principal) Accepted by: country On: /api/v2/gov/fara

coverage_language

Observed vocabulary — a measurement, not an allowlist. These are the 77 values present in the corpus as of 2026-08-10. The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
The languages the corpus actually carries, canonicalized toward ISO 639-1 (639-2 codes are folded to their 2-letter form, and a long tail of 639-3 codes survives for outlets that have no 639-1 code, e.g. tet, crs). The filter validates SHAPE, not membership: it rejects only a token that cannot be an ISO code — a normalized value longer than 3 characters, so languages=english is a 400 while languages=zz is an accepted, empty 200. A code absent from this list may still be valid; it just had no coverage in the measured window. THREE entries are upstream spellings that are NOT folded: axe is Azerbaijani (1,619 rows over 30 days, so languages=az currently returns nothing), glg is Galician, and mon is Mongolian, which is therefore split against the folded mn. Filter on the spelling you see here until they are folded and backfilled together. Discover the current set: GET /api/v2/stories?limit=1 (read coverage.languages) Accepted by: languages On: /api/v2/entities

admin1

Observed vocabulary — a measurement, not an allowlist. These are the 120 values present in the corpus as of 2026-08-10 (3229 distinct in total; the most frequent are listed). The API accepts values outside this list — the corpus grows between refreshes, and refusing a value the warehouse can answer would be worse than an empty result. Treat an unlisted value as possibly valid, not invalid.
Sub-national admin1 NAMES as the corpus spells them — not codes. This is a per-country vocabulary, so the list here is the most-covered slice of a much larger set (the artifact’s distinct count is the real total); resolve the full set for one country through the discovery endpoint. Matching is case-insensitive and folds a trailing administrative suffix on both sides, so Kharkiv Oblast and kharkiv reach the same rows. The filter never rejects an unknown value. District of Columbia · California · Delhi · Texas · New York · Maharashtra · England · Ontario · Florida · Federal Capital Territory · Gauteng · Karnataka · Uttar Pradesh · Ohio · Pennsylvania · Tamil Nadu · British Columbia · Michigan · Punjab · Washington · Illinois · New South Wales · Jakarta · Georgia · Maryland · North Carolina · Kerala · Telangana · West Bengal · Oregon · Arizona · West Bank · Scotland · Massachusetts · Wisconsin · São Paulo · Lazio · Lagos State · Lombardy · Madhya Pradesh · Tennessee · Indiana · Missouri · Virginia · Colorado · Jammu and Kashmir · South Carolina · Community of Madrid · Bihar · Gujarat · Minnesota · Victoria · Hong Kong · Gaza Strip · New Jersey · Alberta · Kentucky · Louisiana · Maine · Andalusia · Odisha · Rajasthan · Central Region · Osun State · Guangdong · East Java · Western Cape · Oklahoma · Andhra Pradesh · Istanbul · Alabama · Île-de-France · Metro Manila · Nevada · West Java · Quebec · Catalonia · Haryana · Attica · Emilia-Romagna · Mexico City · Assam · Buenos Aires Province · Iowa · Sicily · Idaho · Lagos · Arkansas · Federal District · Campania · Dhaka Division · Wales · Kansas · Jharkhand · Utah · West Virginia · Bavaria · Masovian Voivodeship · Hawaii · KwaZulu-Natal · New Mexico · Nebraska · Nairobi County · Shanghai · Queensland · North Rhine-Westphalia · Republika Srpska · Sindh · Dubai · Western Australia · Buenos Aires · Mississippi · Uttarakhand · Western Province · Bucharest Municipality · Vilnius County · Connecticut · Kaduna State · Kano State · Galicia Discover the current set: GET /api/v2/geo/admin1?country=<name|ISO-2|ISO-3|FIPS> Accepted by: admin1 On: /api/v2/events · /api/v2/stories

Identifier spaces

entity_handle

Identifier space — not a vocabulary. This is a key with a format and a resolver, not a list you can enumerate.
A key with a format, not a vocabulary — resolve one with GET /api/v2/search rather than constructing it. Several identifier spaces coexist (spine e_…, news wiki:…, cik:, llm:, GEM entity ids, LEI, UEI) and the set an endpoint accepts differs by endpoint. Sending an id from the wrong space generally returns an empty 200 rather than an error, so check the per-endpoint table at https://docs.gdeltcloud.com/reference/parameters#identifier-parameters before chaining two endpoints. Resolve one with: GET /api/v2/search?q=<name> Accepted by: co_occurring_with, entity, participant_entity On: /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary · /api/v2/facilities · /api/v2/entities

office_id

Identifier space — not a vocabulary. This is a key with a format and a resolver, not a list you can enumerate.
The Wikidata QID of the office (Q…) or the p_… id /api/v2/offices serves. Resolve a name with GET /api/v2/offices?q= first — a name is refused, never guessed. Resolve one with: GET /api/v2/offices?q=<name> Accepted by: office On: /api/v2/events · /api/v2/stories · /api/v2/events/summary · /api/v2/stories/summary

list_source_key

Identifier space — not a vocabulary. This is a key with a format and a resolver, not a list you can enumerate.
A list’s source_key, found with GET /api/v2/lists: every row with ingested: true is a key this parameter accepts. Matching is case-insensitive. A list we know of but do not carry answers 400 INVALID_LIST_SOURCE with details.reason: declared_but_not_ingested, and an unknown key answers it with details.reason: unknown_source_key — never an empty result. Resolve one with: GET /api/v2/lists Accepted by: list, source On: /api/v2/lists · /api/v2/lists/entries · /api/v2/lists/changes

exposure_list

Identifier space — not a vocabulary. This is a key with a format and a resolver, not a list you can enumerate.
What made an exposure row exposed: a list’s source_key from GET /api/v2/lists (rows with ingested: true), or one of two labels that are not lists, state_owned (a state owner) and cn_state (a Chinese state owner). Matching is case-insensitive, and a key we do not carry answers 400 INVALID_LIST_SOURCE. Resolve one with: GET /api/v2/lists Accepted by: list On: /api/v2/exposure

country

Identifier space — not a vocabulary. This is a key with a format and a resolver, not a list you can enumerate.
A country KEY in any of four spellings: ISO 3166-1 alpha-3 (UKR), alpha-2 (UA), FIPS 10-4 (UP), or an English display name or alias (Ukraine). Comma-separate for OR. Two-letter input resolves as ISO-2 FIRST and FIPS second, so CN is China rather than Comoros. An unresolvable value returns 400 INVALID_COUNTRY. region and continent are separate params and ARE closed vocabularies — they expand to a country set. Resolve one with: GET /api/v2/events?group_by=country — returns the ISO-3 codes with display names Accepted by: actor_country, country, source_actor_country, target_actor_country On: /api/v2/activity · /api/v2/countries · /api/v2/events · /api/v2/events/summary · /api/v2/situations · /api/v2/offices