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.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
related_scope
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.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.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.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./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./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.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.
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.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.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.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.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.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.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.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.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.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.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_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./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.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./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, 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.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.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.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.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.
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.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.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.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.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.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.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.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.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.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.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.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.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.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.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.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.all · threats · acts · verbal · material
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.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 · 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.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.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.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.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.
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.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.
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.
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.
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.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.
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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.
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.
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.
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.
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.
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
