A facility fused with its OWNER’s media coverage, plus optional nearby reporting and government exposure. Returns owner_events — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are null rather than empty, so “we did not look” is never mistaken for “we looked and found nothing”. Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage.
Parameters this endpoint deliberately rejects (1)
These return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it.
as_of → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: /api/v2/intelligence/gpr?as_of=, /api/v2/macro/*?as_of=.
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
facility_id
string
required
The facility id.
Query Parameters
days
string
default:30
Owner-coverage window in days, max 30.
date_start
string<date>
Explicit start of the owner-coverage window.
date_end
string<date>
Explicit end of the owner-coverage window.
limit
integer
default:10
Number of owner-linked Events to attach to this facility context.
Required range: 1 <= x <= 50
include
enum<string>[]
Optional extra blocks. gov attaches the owner's federal-award / FARA / sanctions footprint. An unentitled plan degrades the block to null with a sources_unavailable entry — it never 403s the whole response. nearby attaches Events within radius_km and their linked Stories. Nearby reporting is a geographic lead, not a confirmed incident at the site. Full value list: https://docs.gdeltcloud.com/reference/enums#facility_context_include
Available options:
gov,
nearby
radius_km
number
default:25
Distance in kilometres for optional nearby Event screening. Source coordinate precision is disclosed; nearby reporting is a lead, not a confirmed incident at the facility.
Required range: 1 <= x <= 250
Response
Success
success
enum<boolean>
required
Available options:
true
facility
object
required
Show child attributes
window
object
required
Show child attributes
owner
object | null
required
Show child attributes
owner_events
object[] | null
required
Bounded reporting about owners and recorded parents; not events at the site. Null means unmeasured.
Show child attributes
owner_stories
object[] | null
required
Stories referenced by the returned owner Events; not an exhaustive owner Story search.
Show child attributes
owner_footprint
unknown
required
summary
object
required
Counts of the returned owner preview, not all matches.
Show child attributes
next_steps
object[]
required
Show child attributes
meta
object
required
Show child attributes
reported_owner_matches
object[]
Exact reference-name identity discovery for name-only owners; does not verify facility ownership.
Show child attributes
reported_owner_events
object[] | null
Separate best-effort reporting for exact reported-name matches; never promoted to resolved owner_events.
Show child attributes
reported_owner_stories
object[] | null
Show child attributes
nearby_events
object[] | null
Optional geographic leads within radius_km; never proof of an incident at the site.
Show child attributes
nearby_stories
object[] | null
Show child attributes
⌘I
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"GDELT Cloud","colors":{"primary":"#00A3E6","light":"#33C3FF","dark":"#00B8FF"},"logo":{"light":"https://mintcdn.com/gdeltcloud/KTGJpOMcmte0oOTe/logo/light.png?fit=max\u0026auto=format\u0026n=KTGJpOMcmte0oOTe\u0026q=85\u0026s=a78b03b47abd8cab8440d155ed680c34","dark":"https://mintcdn.com/gdeltcloud/miSOHwAydO88jcW5/logo/dark.png?fit=max\u0026auto=format\u0026n=miSOHwAydO88jcW5\u0026q=85\u0026s=ca65237b8e8547e0eef674bbaf79a5e6"},"favicon":"https://mintcdn.com/gdeltcloud/miSOHwAydO88jcW5/favicon.ico?fit=max\u0026auto=format\u0026n=miSOHwAydO88jcW5\u0026q=85\u0026s=f9ab1eb729e9f162c1eca54614c5a903","api":{"openapi":["api-reference/openapi-v2.json"],"playground":{"display":"interactive","proxy":false},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"navbar":{"links":[{"href":"https://gdeltcloud.com/pricing","label":"Pricing"},{"href":"https://gdeltcloud.com/api-arena","label":"API Arena"},{"icon":"activity","href":"https://status.gdeltcloud.com","label":"Status"},{"href":"https://gdeltcloud.com/auth/sign-up?next=%2Fapi-keys","label":"Sign up"}],"primary":{"type":"button","label":"Get started","href":"https://gdeltcloud.com/auth/sign-up?next=%2Fsettings%2Fsubscription%3Fplan%3Dbuilder%26billing_interval%3Dmonth"}},"footer":{"socials":{"github":"https://github.com/gdelt-cloud","linkedin":"https://www.linkedin.com/company/gdelt-cloud","x":"https://x.com/GDELTCloud"},"links":[{"header":"GDELT Cloud","items":[{"label":"Pricing","href":"https://gdeltcloud.com/pricing"},{"label":"Sign up","href":"https://gdeltcloud.com/auth/sign-up?next=%2Fapi-keys"},{"label":"Status","href":"https://status.gdeltcloud.com"}]}]},"seo":{"metatags":{"canonical":"https://docs.gdeltcloud.com","keywords":"GDELT Cloud, geopolitical risk API, global event data API, structured event data, GDELT alternative, news API, MCP server for events, conflict event data, OSINT data API, energy asset data, entity resolution","og:type":"website","og:site_name":"GDELT Cloud","twitter:card":"summary_large_image","twitter:site":"@GDELTCloud","robots":"index, follow","author":"GDELT Cloud","language":"en"},"indexing":"all"},"fonts":{"family":"Geist"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","mcp"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gdeltcloud","hasAudioNarration":false,"actualSubdomain":"gdeltcloud","customDomains":["docs.gdeltcloud.com"],"gitSource":{"type":"github","owner":"ledgerw","repo":"gdelt-cloud","deployBranch":"production","contentDirectory":"gdelt-cloud-docs","isPrivate":true,"mountPath":"","label":"","_id":"6adaae5f07ea8ad7a6970b0f"},"feedback":{"agentFeedback":true},"entitlements":{},"buildId":"6b00b15060f58706661f56c6","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"API Reference","count":100},{"language":"default","tag":"Data Reference","count":26},{"language":"default","tag":"Guides","count":23},{"language":"default","tag":"Monitors","count":16},{"language":"default","tag":"CAMEO+ domain codes","count":10},{"language":"default","tag":"Situations","count":9},{"language":"default","tag":"Filings","count":8},{"language":"default","tag":"Data","count":7},{"language":"default","tag":"Entities","count":7},{"language":"default","tag":"Maritime","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--gdelt-docs-font: \"Inter\", ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,\n \"Segoe UI\", sans-serif}html,body,#navbar,#header,#sidebar,#sidebar-content,#navigation-items,#content-area,#content-container,#body-content,#table-of-contents,#table-of-contents-content,#page-context-menu,.prose{font-family:var(--gdelt-docs-font)!important}h1,h2,h3,h4,h5,h6,#page-title{font-family:var(--gdelt-docs-font)!important;letter-spacing:0}button,input,textarea,select{font-family:inherit}#table-of-contents{max-height:calc(100vh - 7rem);overflow-y:auto;overscroll-behavior:contain}"}]}
{"page":{"pagePath":"api-reference/facilities/facility-context","slug":"/api-reference/facilities/facility-context","pageMetadata":{"title":"Facility context","description":"A facility fused with its OWNER's media coverage, plus optional nearby reporting and government exposure. Returns `owner_events` — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are `null` rather than empty, so \"we did not look\" is never mistaken for \"we looked and found nothing\". Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage.\n\n\u003cAccordion title=\"Parameters this endpoint deliberately rejects (1)\">\n\nThese return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it.\n\n- `as_of` → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: `/api/v2/intelligence/gpr?as_of=`, `/api/v2/macro/*?as_of=`.\n\n\u003c/Accordion>","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}/context","href":"/api-reference/facilities/facility-context","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n }, {Accordion} = _components;\n if (!Accordion) _missingMdxReference(\"Accordion\", true);\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"A facility fused with its OWNER’s media coverage, plus optional nearby reporting and government exposure. Returns \", _jsx(_components.code, {\n children: \"owner_events\"\n }), \" — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are \", _jsx(_components.code, {\n children: \"null\"\n }), \" rather than empty, so “we did not look” is never mistaken for “we looked and found nothing”. Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage.\"]\n }), \"\\n\", _jsxs(Accordion, {\n title: \"Parameters this endpoint deliberately rejects (1)\",\n children: [_jsx(_components.p, {\n children: \"These return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it.\"\n }), _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"as_of\"\n }), \" → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: \", _jsx(_components.code, {\n children: \"/api/v2/intelligence/gpr?as_of=\"\n }), \", \", _jsx(_components.code, {\n children: \"/api/v2/macro/*?as_of=\"\n }), \".\"]\n }), \"\\n\"]\n })]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Facility context","description":"A facility fused with its OWNER's media coverage, plus optional nearby reporting and government exposure. Returns `owner_events` — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are `null` rather than empty, so \"we did not look\" is never mistaken for \"we looked and found nothing\". Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage.\n\n\u003cAccordion title=\"Parameters this endpoint deliberately rejects (1)\">\n\nThese return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it.\n\n- `as_of` → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: `/api/v2/intelligence/gpr?as_of=`, `/api/v2/macro/*?as_of=`.\n\n\u003c/Accordion>","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}/context","href":"/api-reference/facilities/facility-context","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"get-facility-context-v2","summary":"Facility context","description":"A facility fused with its OWNER's media coverage, plus optional nearby reporting and government exposure. Returns `owner_events` — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are `null` rather than empty, so \"we did not look\" is never mistaken for \"we looked and found nothing\". Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage.\n\n\u003cAccordion title=\"Parameters this endpoint deliberately rejects (1)\">\n\nThese return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it.\n\n- `as_of` → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: `/api/v2/intelligence/gpr?as_of=`, `/api/v2/macro/*?as_of=`.\n\n\u003c/Accordion>","tags":["Facilities"],"parameters":["e5fb8a11-684e-418d-9705-2a2334f80ada","987114a2-1472-4f2b-a2ef-2d5b6ce364a4","b43d3fee-4069-48f5-bf11-ceae0a682063","9005f2f4-5f44-490f-9099-e58e1c35c734","05e498b0-04e8-4973-b13f-d825911e6670","bc2f3d1f-8716-4ea4-8a7b-4cd68b7da2cf","6dd1f2e4-efa6-4360-a238-60881ff90e8d"],"security":["3a70df74-453c-4e46-8aff-db8b2e278117"],"responses":{"200":"e217918d-ddce-4398-b44d-5f65ac750d99","400":"8c05dcca-3e3a-4d7b-9430-27aeb120fc02","401":"d15f3a53-4fb8-4fd8-a316-a3cebd5a1dc9","403":"0675b310-e56e-4db2-a55a-a51744f190ab","429":"e51df802-26fa-41e9-9136-f3ac107a010f","500":"86532b00-e5a0-421e-93b2-1c3f6d82a5be"},"x-plan-feature":"can_use_facilities","method":"get","type":"path","servers":["d28bc35b-fd47-4d2b-a0a5-d865b3182cd8"],"path":"/api/v2/facilities/{facility_id}/context","baseUrlOptions":["https://gdeltcloud.com"],"title":"Facility context","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"e5fb8a11-684e-418d-9705-2a2334f80ada":{"name":"facility_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The facility id.","uniqueKey":"","typeLabel":"string"},"description":"The facility id."},"987114a2-1472-4f2b-a2ef-2d5b6ce364a4":{"name":"days","in":"query","required":false,"schema":{"type":"string","default":"30","isRequired":false,"description":"Owner-coverage window in days, max 30.","uniqueKey":"","typeLabel":"string"},"description":"Owner-coverage window in days, max 30.","example":"30"},"b43d3fee-4069-48f5-bf11-ceae0a682063":{"name":"date_start","in":"query","required":false,"schema":{"type":"string","format":"date","isRequired":false,"description":"Explicit start of the owner-coverage window.","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Explicit start of the owner-coverage window.","example":"2026-08-01"},"9005f2f4-5f44-490f-9099-e58e1c35c734":{"name":"date_end","in":"query","required":false,"schema":{"type":"string","format":"date","isRequired":false,"description":"Explicit end of the owner-coverage window.","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Explicit end of the owner-coverage window.","example":"2026-08-04"},"05e498b0-04e8-4973-b13f-d825911e6670":{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10,"isRequired":false,"description":"Number of owner-linked Events to attach to this facility context.","uniqueKey":"","typeLabel":"integer"},"description":"Number of owner-linked Events to attach to this facility context.","example":"10"},"bc2f3d1f-8716-4ea4-8a7b-4cd68b7da2cf":{"name":"include","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["gov","nearby"],"uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":false,"description":"Optional extra blocks. `gov` attaches the owner's federal-award / FARA / sanctions footprint. An unentitled plan degrades the block to null with a `sources_unavailable` entry — it never 403s the whole response. `nearby` attaches Events within radius_km and their linked Stories. Nearby reporting is a geographic lead, not a confirmed incident at the site. Full value list: https://docs.gdeltcloud.com/reference/enums#facility_context_include","uniqueKey":"","typeLabel":"enum\u003cstring>[]"},"description":"Optional extra blocks. `gov` attaches the owner's federal-award / FARA / sanctions footprint. An unentitled plan degrades the block to null with a `sources_unavailable` entry — it never 403s the whole response. `nearby` attaches Events within radius_km and their linked Stories. Nearby reporting is a geographic lead, not a confirmed incident at the site. Full value list: https://docs.gdeltcloud.com/reference/enums#facility_context_include","example":"gov"},"6dd1f2e4-efa6-4360-a238-60881ff90e8d":{"name":"radius_km","in":"query","required":false,"schema":{"type":"number","minimum":1,"maximum":250,"default":25,"isRequired":false,"description":"Distance in kilometres for optional nearby Event screening. Source coordinate precision is disclosed; nearby reporting is a lead, not a confirmed incident at the facility.","uniqueKey":"","typeLabel":"number"},"description":"Distance in kilometres for optional nearby Event screening. Source coordinate precision is disclosed; nearby reporting is a lead, not a confirmed incident at the facility.","example":"25"}},"responses":{"e217918d-ddce-4398-b44d-5f65ac750d99":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"facility":{"type":"object","properties":{"facility_id":{"type":"string","description":"Identifier for this row: canonical `s_…` site id in the default site view, or source registry-unit `f_…` id with `granularity=unit`.","isRequired":true,"uniqueKey":"facility.facility_id","typeLabel":"string"},"canonical_site_id":{"type":"string","description":"Canonical `s_…` physical-site id shared by every registry unit at the site.","isRequired":true,"uniqueKey":"facility.canonical_site_id","typeLabel":"string"},"granularity":{"type":"string","enum":["site","unit"],"isRequired":true,"uniqueKey":"facility.granularity","typeLabel":"enum\u003cstring>"},"unit_id":{"oneOf":[{"type":"string","description":"Source registry-unit `f_…` id on unit rows; null on canonical site rows.","isRequired":true,"uniqueKey":"facility.unit_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Source registry-unit `f_…` id on unit rows; null on canonical site rows.","isRequired":true,"uniqueKey":"facility.unit_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.unit_id","typeLabel":"string | null"},"unit_count":{"type":"number","description":"Distinct source registry units represented by this row.","isRequired":true,"uniqueKey":"facility.unit_count","typeLabel":"number"},"unit_ids":{"type":"array","items":{"type":"string","uniqueKey":"facility.unit_ids.items.[INDEX]","typeLabel":"string"},"description":"Source registry-unit ids represented by this site or unit row.","isRequired":true,"uniqueKey":"facility.unit_ids","typeLabel":"string[]"},"unit_statuses":{"type":"array","items":{"type":"object","properties":{"facility_id":{"type":"string","description":"Source registry-unit `f_…` id.","isRequired":true,"uniqueKey":"facility.unit_statuses.items.[INDEX].facility_id","typeLabel":"string"},"status_source":{"oneOf":[{"type":"string","description":"Status exactly as published by the source registry.","isRequired":true,"uniqueKey":"facility.unit_statuses.items.[INDEX].status_source.oneOf.0","typeLabel":"string"},{"type":"null","description":"Status exactly as published by the source registry.","isRequired":true,"uniqueKey":"facility.unit_statuses.items.[INDEX].status_source.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.unit_statuses.items.[INDEX].status_source","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","description":"Normalized lower-case lifecycle status; null when unknown.","isRequired":true,"uniqueKey":"facility.unit_statuses.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","description":"Normalized lower-case lifecycle status; null when unknown.","isRequired":true,"uniqueKey":"facility.unit_statuses.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.unit_statuses.items.[INDEX].status","typeLabel":"string | null"}},"required":["facility_id","status_source","status"],"uniqueKey":"facility.unit_statuses.items.[INDEX]","typeLabel":"object"},"description":"Per-unit source and normalized status evidence.","isRequired":true,"uniqueKey":"facility.unit_statuses","typeLabel":"object[]"},"status_breakdown":{"type":"array","items":{"type":"object","properties":{"status":{"oneOf":[{"type":"string","description":"Normalized lower-case lifecycle status; null means unknown.","isRequired":true,"uniqueKey":"facility.status_breakdown.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","description":"Normalized lower-case lifecycle status; null means unknown.","isRequired":true,"uniqueKey":"facility.status_breakdown.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.status_breakdown.items.[INDEX].status","typeLabel":"string | null"},"unit_count":{"type":"number","isRequired":true,"uniqueKey":"facility.status_breakdown.items.[INDEX].unit_count","typeLabel":"number"}},"required":["status","unit_count"],"uniqueKey":"facility.status_breakdown.items.[INDEX]","typeLabel":"object"},"description":"Registry-unit counts by normalized lifecycle status.","isRequired":true,"uniqueKey":"facility.status_breakdown","typeLabel":"object[]"},"name":{"type":"string","isRequired":true,"uniqueKey":"facility.name","typeLabel":"string"},"facility_type":{"type":"string","isRequired":true,"uniqueKey":"facility.facility_type","typeLabel":"string"},"facility_class":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"facility.facility_class.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"facility.facility_class.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.facility_class","typeLabel":"string | null"},"source_silo":{"type":"string","isRequired":true,"uniqueKey":"facility.source_silo","typeLabel":"string"},"source_memberships":{"type":"array","items":{"type":"string","uniqueKey":"facility.source_memberships.items.[INDEX]","typeLabel":"string"},"description":"All source memberships of the canonical physical site.","isRequired":true,"uniqueKey":"facility.source_memberships","typeLabel":"string[]"},"commodities":{"type":"array","items":{"type":"string","uniqueKey":"facility.commodities.items.[INDEX]","typeLabel":"string"},"description":"Normalized commodity memberships; a mine and processing plant retain separate identities.","isRequired":true,"uniqueKey":"facility.commodities","typeLabel":"string[]"},"geo_precision":{"oneOf":[{"type":"string","description":"Source coordinate precision; nearby reporting is only a geographic screen.","isRequired":true,"uniqueKey":"facility.geo_precision.oneOf.0","typeLabel":"string"},{"type":"null","description":"Source coordinate precision; nearby reporting is only a geographic screen.","isRequired":true,"uniqueKey":"facility.geo_precision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.geo_precision","typeLabel":"string | null"},"geo_evidence":{"oneOf":[{"description":"Retained source evidence for the selected point coordinates.","isRequired":true,"uniqueKey":"facility.geo_evidence.oneOf.0","typeLabel":"any"},{"description":"Retained source evidence for the selected point coordinates.","type":"null","isRequired":true,"uniqueKey":"facility.geo_evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.geo_evidence","typeLabel":"any | null"},"observations_url":{"type":"string","isRequired":true,"uniqueKey":"facility.observations_url","typeLabel":"string"},"relationships_url":{"type":"string","isRequired":true,"uniqueKey":"facility.relationships_url","typeLabel":"string"},"country_iso3":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"facility.country_iso3.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"facility.country_iso3.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.country_iso3","typeLabel":"string | null"},"lat":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"facility.lat.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"facility.lat.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.lat","typeLabel":"number | null"},"lon":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"facility.lon.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"facility.lon.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.lon","typeLabel":"number | null"},"status":{"oneOf":[{"type":"string","description":"`mixed` when represented units disagree; otherwise a normalized lower-case lifecycle status. Null means unknown.","isRequired":true,"uniqueKey":"facility.status.oneOf.0","typeLabel":"string"},{"type":"null","description":"`mixed` when represented units disagree; otherwise a normalized lower-case lifecycle status. Null means unknown.","isRequired":true,"uniqueKey":"facility.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.status","typeLabel":"string | null"},"status_source":{"oneOf":[{"type":"string","description":"Single raw source status when all represented units agree; null otherwise.","isRequired":true,"uniqueKey":"facility.status_source.oneOf.0","typeLabel":"string"},{"type":"null","description":"Single raw source status when all represented units agree; null otherwise.","isRequired":true,"uniqueKey":"facility.status_source.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.status_source","typeLabel":"string | null"},"status_sources":{"type":"array","items":{"type":"string","uniqueKey":"facility.status_sources.items.[INDEX]","typeLabel":"string"},"description":"Distinct raw status spellings published by the source registry.","isRequired":true,"uniqueKey":"facility.status_sources","typeLabel":"string[]"},"capacity_mw":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"facility.capacity_mw.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"facility.capacity_mw.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.capacity_mw","typeLabel":"number | null"},"owners":{"type":"array","items":{"type":"object","properties":{"entity_id":{"oneOf":[{"type":"string","description":"Terminal spine `e_…` id. Null when the source names an owner that has not resolved to the spine.","isRequired":true,"uniqueKey":"facility.owners.items.[INDEX].entity_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Terminal spine `e_…` id. Null when the source names an owner that has not resolved to the spine.","isRequired":true,"uniqueKey":"facility.owners.items.[INDEX].entity_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.owners.items.[INDEX].entity_id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"facility.owners.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"facility.owners.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.owners.items.[INDEX].name","typeLabel":"string | null"}},"required":["entity_id","name"],"uniqueKey":"facility.owners.items.[INDEX]","typeLabel":"object"},"description":"Atomic owner records; ids and names are never separate positional arrays.","isRequired":true,"uniqueKey":"facility.owners","typeLabel":"object[]"},"attributes":{"description":"Source-specific physical-asset attributes.","isRequired":true,"uniqueKey":"facility.attributes","typeLabel":"any"},"url":{"oneOf":[{"type":"string","description":"Public GDELT Cloud facility record. Use for human-facing citations; null when no valid facility identity is available.","isRequired":true,"uniqueKey":"facility.url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public GDELT Cloud facility record. Use for human-facing citations; null when no valid facility identity is available.","isRequired":true,"uniqueKey":"facility.url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.url","typeLabel":"string | null"},"detail_url":{"type":"string","description":"REST API detail path; use url for a public facility page.","isRequired":true,"uniqueKey":"facility.detail_url","typeLabel":"string"},"matched_participation":{"type":"object","properties":{"entity_id":{"type":"string","description":"Terminal entity selected by participant_entity.","isRequired":true,"uniqueKey":"facility.matched_participation.entity_id","typeLabel":"string"},"records":{"type":"array","items":{"type":"object","properties":{"participant_id":{"type":"string","isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].participant_id","typeLabel":"string"},"source":{"type":"string","isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].source","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].name","typeLabel":"string"},"role":{"type":"string","isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].role","typeLabel":"string"},"share":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].share.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].share.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].share","typeLabel":"number | null"},"resolution_status":{"type":"string","isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].resolution_status","typeLabel":"string"},"evidence":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].evidence","typeLabel":"null"},"claim_status":{"type":"string","enum":["reported","probable","verified","unresolved"],"isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].claim_status","typeLabel":"enum\u003cstring>"},"assertion_refs":{"type":"array","items":{"type":"string","uniqueKey":"facility.matched_participation.records.items.[INDEX].assertion_refs.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"facility.matched_participation.records.items.[INDEX].assertion_refs","typeLabel":"string[]"}},"required":["participant_id","source","name","role","share","resolution_status","evidence","claim_status","assertion_refs"],"uniqueKey":"facility.matched_participation.records.items.[INDEX]","typeLabel":"object"},"maxItems":25,"isRequired":true,"uniqueKey":"facility.matched_participation.records","typeLabel":"object[]"},"truncated":{"type":"boolean","isRequired":true,"uniqueKey":"facility.matched_participation.truncated","typeLabel":"boolean"}},"required":["entity_id","records","truncated"],"description":"Present only with participant_entity. Matching source assertions for this entity, restricted to the selected role when participant_role is provided. A compute-user, operator or tenant role is not ownership. At most 25 assertions per physical site; inspect truncated.","uniqueKey":"facility.matched_participation","typeLabel":"object"},"news_activity":{"type":"object","properties":{"observed_event_count":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"facility.news_activity.observed_event_count.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"facility.news_activity.observed_event_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.news_activity.observed_event_count","typeLabel":"number | null"},"owner_event_count":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"facility.news_activity.owner_event_count.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"facility.news_activity.owner_event_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.news_activity.owner_event_count","typeLabel":"number | null"},"nearby_event_count":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"facility.news_activity.nearby_event_count.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"facility.news_activity.nearby_event_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.news_activity.nearby_event_count","typeLabel":"number | null"},"latest_event_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"facility.news_activity.latest_event_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"facility.news_activity.latest_event_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.news_activity.latest_event_date","typeLabel":"string | null"}},"required":["observed_event_count","owner_event_count","nearby_event_count","latest_event_date"],"description":"Only present with sort=news_activity. Distinct canonical Events in the exact served dates disclosed by meta.news_activity. Owner and nearby counts overlap; use observed_event_count for their union. Missing matching scopes remain null.","uniqueKey":"facility.news_activity","typeLabel":"object"},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window.","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.recent_count","typeLabel":"number"},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.baseline_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.baseline_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.rising.oneOf.0.baseline_count","typeLabel":"number | null"},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.expected_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.expected_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.rising.oneOf.0.expected_count","typeLabel":"number | null"},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.change.oneOf.0","typeLabel":"number"},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.change.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.rising.oneOf.0.change","typeLabel":"number | null"},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key.","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.score","typeLabel":"number"},"recent_start":{"type":"string","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.recent_start","typeLabel":"string"},"recent_end":{"type":"string","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.recent_end","typeLabel":"string"},"baseline_start":{"type":"string","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.baseline_start","typeLabel":"string"},"baseline_end":{"type":"string","isRequired":true,"uniqueKey":"facility.rising.oneOf.0.baseline_end","typeLabel":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising; null when the site is below the recent floor.","uniqueKey":"facility.rising.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising; null when the site is below the recent floor.","uniqueKey":"facility.rising.oneOf.1","typeLabel":"null"}],"uniqueKey":"facility.rising","typeLabel":"object | null"},"name_local":{"type":"string","uniqueKey":"facility.name_local","typeLabel":"string"},"gem_tracker":{"type":"string","uniqueKey":"facility.gem_tracker","typeLabel":"string"},"secondary_country_iso3":{"type":"string","uniqueKey":"facility.secondary_country_iso3","typeLabel":"string"},"countries":{"type":"array","items":{"type":"string","uniqueKey":"facility.countries.items.[INDEX]","typeLabel":"string"},"description":"Only with group_pipelines=true. Every country the facility is in, sorted ISO-3, present only when there is more than one: a site's secondary location country (a pipeline's end, a binational dam's other bank; an LNG carrier's shipyard country is not a location and is never listed), or every start and end country of a multi-country pipeline's segments. Absent means `country_iso3` is the only country.","uniqueKey":"facility.countries","typeLabel":"string[]"},"segment_count":{"type":"number","description":"Only with group_pipelines=true, on a GEM gas or oil pipeline whose segments span more than one country: how many canonical sites it has. The row is that one pipeline; facility_id, coordinates and attributes are a representative segment that met the filters.","uniqueKey":"facility.segment_count","typeLabel":"number"},"segments":{"type":"array","items":{"type":"object","properties":{"canonical_site_id":{"type":"string","description":"Canonical `s_…` site id of the segment; GET /api/v2/facilities/{facility_id} returns it alone.","isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].canonical_site_id","typeLabel":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Country the segment starts in.","isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].country_iso3.oneOf.0","typeLabel":"string"},{"type":"null","description":"Country the segment starts in.","isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].country_iso3.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].country_iso3","typeLabel":"string | null"},"secondary_country_iso3":{"oneOf":[{"type":"string","description":"Country the segment ends in, when it is another.","isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].secondary_country_iso3.oneOf.0","typeLabel":"string"},{"type":"null","description":"Country the segment ends in, when it is another.","isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].secondary_country_iso3.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].secondary_country_iso3","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","description":"Normalized lower-case lifecycle status of the segment; `mixed` when its registry units disagree, null when unknown.","isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].status.oneOf.0","typeLabel":"string"},{"type":"null","description":"Normalized lower-case lifecycle status of the segment; `mixed` when its registry units disagree, null when unknown.","isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].status","typeLabel":"string | null"},"matched":{"type":"boolean","description":"The segment met every filter of this request, so the row's unit, status, owner and coordinate fields include it; with sort=news_activity the row is ranked by its best-ranked segment alone.","isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].matched","typeLabel":"boolean"},"detail_url":{"type":"string","isRequired":true,"uniqueKey":"facility.segments.items.[INDEX].detail_url","typeLabel":"string"}},"required":["canonical_site_id","country_iso3","secondary_country_iso3","status","matched","detail_url"],"uniqueKey":"facility.segments.items.[INDEX]","typeLabel":"object"},"description":"Every segment of the multi-country pipeline, sorted by id; see segment_count.","uniqueKey":"facility.segments","typeLabel":"object[]"},"geom_wkt":{"type":"string","uniqueKey":"facility.geom_wkt","typeLabel":"string"},"address":{"type":"string","uniqueKey":"facility.address","typeLabel":"string"},"unlocode":{"type":"string","uniqueKey":"facility.unlocode","typeLabel":"string"},"capacity":{"type":"object","properties":{"value":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"facility.capacity.value.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"facility.capacity.value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.capacity.value","typeLabel":"number | null"},"unit":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"facility.capacity.unit.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"facility.capacity.unit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.capacity.unit","typeLabel":"string | null"}},"required":["value","unit"],"description":"Native registry-unit capacity. Unknown on a multi-unit site; no conversion or cross-unit aggregation is inferred.","uniqueKey":"facility.capacity","typeLabel":"object"},"unit_capacities":{"type":"array","items":{"type":"object","properties":{"facility_id":{"type":"string","isRequired":true,"uniqueKey":"facility.unit_capacities.items.[INDEX].facility_id","typeLabel":"string"},"value":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"facility.unit_capacities.items.[INDEX].value.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"facility.unit_capacities.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.unit_capacities.items.[INDEX].value","typeLabel":"number | null"},"unit":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"facility.unit_capacities.items.[INDEX].unit.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"facility.unit_capacities.items.[INDEX].unit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"facility.unit_capacities.items.[INDEX].unit","typeLabel":"string | null"}},"required":["facility_id","value","unit"],"uniqueKey":"facility.unit_capacities.items.[INDEX]","typeLabel":"object"},"description":"Per-registry-unit native capacities. Values remain null until retained by the source projection; units such as mtpa are not MW.","uniqueKey":"facility.unit_capacities","typeLabel":"object[]"},"first_seen_date":{"type":"string","uniqueKey":"facility.first_seen_date","typeLabel":"string"},"last_seen_date":{"type":"string","uniqueKey":"facility.last_seen_date","typeLabel":"string"},"owner_portfolio_url":{"type":"string","uniqueKey":"facility.owner_portfolio_url","typeLabel":"string"}},"required":["facility_id","canonical_site_id","granularity","unit_id","unit_count","unit_ids","unit_statuses","status_breakdown","name","facility_type","facility_class","source_silo","source_memberships","commodities","geo_precision","geo_evidence","observations_url","relationships_url","country_iso3","lat","lon","status","status_source","status_sources","capacity_mw","owners","attributes","url","detail_url"],"isRequired":true,"uniqueKey":"facility","typeLabel":"object"},"window":{"type":"object","properties":{"days":{"type":"number","isRequired":true,"uniqueKey":"window.days","typeLabel":"number"},"date_start":{"type":"string","isRequired":true,"uniqueKey":"window.date_start","typeLabel":"string"},"date_end":{"type":"string","isRequired":true,"uniqueKey":"window.date_end","typeLabel":"string"}},"required":["days","date_start","date_end"],"isRequired":true,"uniqueKey":"window","typeLabel":"object"},"owner":{"oneOf":[{"type":"object","properties":{"entity_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.entity_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.entity_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.entity_id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.name","typeLabel":"string | null"},"bridged":{"type":"boolean","isRequired":true,"uniqueKey":"owner.oneOf.0.bridged","typeLabel":"boolean"},"coverage_via":{"type":"string","enum":["owner","parent","owner_and_parent"],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_via","typeLabel":"enum\u003cstring>"},"coverage_entity_ids":{"type":"array","items":{"type":"string","uniqueKey":"owner.oneOf.0.coverage_entity_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_entity_ids","typeLabel":"string[]"},"coverage_paths":{"type":"array","items":{"type":"object","properties":{"entity_id":{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].entity_id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].name","typeLabel":"string | null"},"via":{"type":"string","enum":["owner","parent"],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].via","typeLabel":"enum\u003cstring>"},"rolled_up_from":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].rolled_up_from.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].rolled_up_from.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].rolled_up_from","typeLabel":"string | null"},"edge_type":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].edge_type.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].edge_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].edge_type","typeLabel":"string | null"},"ownership_pct":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].ownership_pct.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].ownership_pct.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].ownership_pct","typeLabel":"number | null"},"confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].confidence","typeLabel":"number | null"},"source":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].source.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].source.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].source","typeLabel":"string | null"},"provenance_cik":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].provenance_cik.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].provenance_cik.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].provenance_cik","typeLabel":"string | null"},"provenance_accession":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].provenance_accession.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].provenance_accession.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].provenance_accession","typeLabel":"string | null"},"bridged":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].bridged.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].bridged.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].bridged","typeLabel":"boolean | null"},"relationship_role":{"type":"string","enum":["owner","parent","ownership"],"description":"Recorded relationship role. An ownership stake is not evidence of corporate control; via identifies the lookup path.","isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX].relationship_role","typeLabel":"enum\u003cstring>"}},"required":["entity_id","name","via","rolled_up_from","edge_type","ownership_pct","confidence","source","provenance_cik","provenance_accession","bridged","relationship_role"],"uniqueKey":"owner.oneOf.0.coverage_paths.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner.oneOf.0.coverage_paths","typeLabel":"object[]"},"resolved_owner_count":{"type":"number","isRequired":true,"uniqueKey":"owner.oneOf.0.resolved_owner_count","typeLabel":"number"},"bridged_owner_count":{"type":"number","isRequired":true,"uniqueKey":"owner.oneOf.0.bridged_owner_count","typeLabel":"number"},"owners_truncated":{"type":"boolean","isRequired":true,"uniqueKey":"owner.oneOf.0.owners_truncated","typeLabel":"boolean"},"owners_considered":{"type":"array","items":{"type":"object","properties":{"entity_id":{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.owners_considered.items.[INDEX].entity_id","typeLabel":"string"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.owners_considered.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.owners_considered.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.owners_considered.items.[INDEX].name","typeLabel":"string | null"},"bridged":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"owner.oneOf.0.owners_considered.items.[INDEX].bridged.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.owners_considered.items.[INDEX].bridged.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.owners_considered.items.[INDEX].bridged","typeLabel":"boolean | null"}},"required":["entity_id","name","bridged"],"uniqueKey":"owner.oneOf.0.owners_considered.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner.oneOf.0.owners_considered","typeLabel":"object[]"},"parent_lookup_failed":{"type":"boolean","isRequired":true,"uniqueKey":"owner.oneOf.0.parent_lookup_failed","typeLabel":"boolean"},"parent_scope_too_large":{"type":"boolean","isRequired":true,"uniqueKey":"owner.oneOf.0.parent_scope_too_large","typeLabel":"boolean"},"dossier_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.dossier_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.dossier_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.dossier_url","typeLabel":"string | null"},"portfolio_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner.oneOf.0.portfolio_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner.oneOf.0.portfolio_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner.oneOf.0.portfolio_url","typeLabel":"string | null"}},"required":["entity_id","name","bridged","coverage_via","coverage_entity_ids","coverage_paths","resolved_owner_count","bridged_owner_count","owners_truncated","owners_considered","parent_lookup_failed","parent_scope_too_large","dossier_url","portfolio_url"],"isRequired":true,"uniqueKey":"owner.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"entity_id":{"oneOf":[{"type":"string"},{"type":"null"}]},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"bridged":{"type":"boolean"},"coverage_via":{"type":"string","enum":["owner","parent","owner_and_parent"]},"coverage_entity_ids":{"type":"array","items":{"type":"string"}},"coverage_paths":{"type":"array","items":{"type":"object","properties":{"entity_id":{"type":"string"},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"via":{"type":"string","enum":["owner","parent"]},"rolled_up_from":{"oneOf":[{"type":"string"},{"type":"null"}]},"edge_type":{"oneOf":[{"type":"string"},{"type":"null"}]},"ownership_pct":{"oneOf":[{"type":"number"},{"type":"null"}]},"confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"source":{"oneOf":[{"type":"string"},{"type":"null"}]},"provenance_cik":{"oneOf":[{"type":"string"},{"type":"null"}]},"provenance_accession":{"oneOf":[{"type":"string"},{"type":"null"}]},"bridged":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"relationship_role":{"type":"string","enum":["owner","parent","ownership"],"description":"Recorded relationship role. An ownership stake is not evidence of corporate control; via identifies the lookup path."}},"required":["entity_id","name","via","rolled_up_from","edge_type","ownership_pct","confidence","source","provenance_cik","provenance_accession","bridged","relationship_role"]}},"resolved_owner_count":{"type":"number"},"bridged_owner_count":{"type":"number"},"owners_truncated":{"type":"boolean"},"owners_considered":{"type":"array","items":{"type":"object","properties":{"entity_id":{"type":"string"},"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"bridged":{"oneOf":[{"type":"boolean"},{"type":"null"}]}},"required":["entity_id","name","bridged"]}},"parent_lookup_failed":{"type":"boolean"},"parent_scope_too_large":{"type":"boolean"},"dossier_url":{"oneOf":[{"type":"string"},{"type":"null"}]},"portfolio_url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["entity_id","name","bridged","coverage_via","coverage_entity_ids","coverage_paths","resolved_owner_count","bridged_owner_count","owners_truncated","owners_considered","parent_lookup_failed","parent_scope_too_large","dossier_url","portfolio_url"],"isRequired":true,"uniqueKey":"owner.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner","typeLabel":"object | null"},"owner_events":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].id","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"primary_story_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].primary_story_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].primary_story_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].primary_story_url","typeLabel":"string | null"},"family":{"type":"string","enum":["conflict","cameoplus"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].family","typeLabel":"enum\u003cstring>"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].title","typeLabel":"string | null"},"title_source":{"type":"string","enum":["coder_title","cluster_label","event_description","actor_pair","actor","sub_event_type","event_type_in_location","event_type","domain_in_location","domain","fallback"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].title_source","typeLabel":"enum\u003cstring>"},"summary":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].summary.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].summary.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].summary","typeLabel":"string | null"},"event_date":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_date","typeLabel":"string"},"observed_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].observed_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].observed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].observed_at","typeLabel":"string | null"},"event_date_basis":{"oneOf":[{"type":"string","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_date_basis.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_date_basis.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_date_basis","typeLabel":"enum\u003cstring> | null"},"event_date_evidence":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_date_evidence.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_date_evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_date_evidence","typeLabel":"string | null"},"coded_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].coded_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].coded_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].coded_at","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].updated_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].updated_at","typeLabel":"string | null"},"processed_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].processed_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].processed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].processed_at","typeLabel":"string | null"},"category":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].category.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].category.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].category","typeLabel":"string | null"},"subcategory":{"oneOf":[{"type":"string","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].subcategory.oneOf.0","typeLabel":"string"},{"type":"null","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].subcategory.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].subcategory","typeLabel":"string | null"},"subcategory_label":{"oneOf":[{"type":"string","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].subcategory_label.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].subcategory_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].subcategory_label","typeLabel":"string | null"},"event_description":{"oneOf":[{"type":"string","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_description.oneOf.0","typeLabel":"string"},{"type":"null","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_description","typeLabel":"string | null"},"taxonomy_status":{"type":"string","enum":["coded","detail_missing","undeclared_code"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].taxonomy_status","typeLabel":"enum\u003cstring>"},"domain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].domain","typeLabel":"string | null"},"event_code":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_code.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].event_code","typeLabel":"string | null"},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.country","typeLabel":"string | null"},"region":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.region.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.region.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.region","typeLabel":"string | null"},"continent":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.continent.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.continent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.continent","typeLabel":"string | null"},"admin1":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.admin1.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.admin1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.admin1","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.location.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.location","typeLabel":"string | null"},"latitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.latitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.latitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.longitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.longitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.longitude","typeLabel":"number | null"},"geo_precision":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.geo_precision","typeLabel":"number | null"},"geo_precision_label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo.geo_precision_label","typeLabel":"string | null"}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo","typeLabel":"object"},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo_context.location_country","typeLabel":"string | null"},"actor_origin_countries":{"type":"array","items":{"type":"string","uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo_context.actor_origin_countries","typeLabel":"string[]"}},"required":["location_country","actor_origin_countries"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].geo_context","typeLabel":"object"},"actors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].name","typeLabel":"string"},"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].country","typeLabel":"string | null"},"role":{"type":"string","enum":["source","target","actor1","actor2"],"description":"The part this actor played. CAMEO+ events are directed: `source` acted, `target` was acted upon. Conflict (ACLED) events are undirected and use `actor1`/`actor2`, which imply no initiator. The two pairs never mix on one card — `family` determines which you get.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"primary":{"type":"boolean","description":"True for the coder's PRIMARY actor in this role — the one entity the event is chiefly about on that side, and the one carried in the `source_actor` / `target_actor` columns and filters. False for a co-actor: another entity in the same role in the same action. `actors[]` is ordered primaries-first, and there is at most one `primary: true` per role.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].primary","typeLabel":"boolean"},"source_entity_id":{"type":"string","description":"Original actor handle before published canonical identity resolution; actor role is retained.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].source_entity_id","typeLabel":"string"},"entity_id":{"type":"string","description":"In Event responses and facility context previews, an unambiguous identity for this actor, referencing entity_refs. Added through existing identity evidence or a unique exact name/alias lookup; absent for unresolved or conflicting identities.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].entity_id","typeLabel":"string"}},"required":["name","country","role","primary"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].actors","typeLabel":"object[]"},"metrics":{"type":"object","properties":{"significance":{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.significance","typeLabel":"number"},"severity_tier":{"type":"string","description":"A severity label from reported deaths, civilian targeting and intensity. It is not a band of `significance`, and nothing sorts or filters on it. `critical`: 10 or more deaths, or 3 or more with civilians targeted. `high`: 3 to 9 deaths, or 1 or 2 with civilians targeted. `medium`: 1 or 2 deaths; civilians targeted with no deaths reported; or `magnitude` of 7 or more, or `systemic_importance` of 0.7 or more. `low`: everything else. Deaths and civilian targeting are coded on conflict events only, so a CAMEO+ event is `medium` at most.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.severity_tier","typeLabel":"string"},"goldstein_scale":{"oneOf":[{"type":"number","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.goldstein_scale.oneOf.0","typeLabel":"number"},{"type":"null","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.goldstein_scale.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.goldstein_scale","typeLabel":"number | null"},"magnitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.magnitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.magnitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.magnitude","typeLabel":"number | null"},"systemic_importance":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.systemic_importance.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.systemic_importance.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.systemic_importance","typeLabel":"number | null"},"propagation_potential":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.propagation_potential.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.propagation_potential.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.propagation_potential","typeLabel":"number | null"},"market_sensitivity":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.market_sensitivity.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.market_sensitivity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.market_sensitivity","typeLabel":"number | null"},"confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.confidence","typeLabel":"number | null"},"article_count":{"oneOf":[{"type":"number","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.article_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.article_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.article_count","typeLabel":"number | null"},"evidence_source_count":{"type":"number","description":"Distinct source URLs attached directly to the Event evidence.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.evidence_source_count","typeLabel":"number"},"supporting_story_count":{"type":"number","description":"Number of canonical Story references attached to the Event.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.supporting_story_count","typeLabel":"number"},"metric_inputs":{"description":"The EVIDENCE BEHIND THE SCORES — for each metric, the sub-factor values the coder read off the article and the reason it gave for each, keyed by metric. This is what makes a metric auditable rather than something to trust: the published formula turns these inputs into the served value, so you can recompute it yourself. Keyed `magnitude`, `systemic`, `propagation` and `market`; each sub-factor is `{value, why}`, beside descriptive keys such as `node`, and `magnitude` carries its `path`, `value` and `why` directly. Present on most CAMEO+ events; OMITTED where no sub-factor evidence was recorded, which is not the same as none existing — events coded before the field was stored carry nothing, and a backfill has not run. Sub-factor definitions and the formulas: https://docs.gdeltcloud.com/reference/metrics","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.metric_inputs","typeLabel":"any"},"metric_arithmetic":{"type":"object","properties":{"magnitude":{"type":"string","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.magnitude","typeLabel":"string"},"systemic_importance":{"type":"string","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.systemic_importance","typeLabel":"string"},"propagation_potential":{"type":"string","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.propagation_potential","typeLabel":"string"},"market_sensitivity":{"type":"string","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.market_sensitivity","typeLabel":"string"}},"description":"The ARITHMETIC behind each scaled score: its published formula with this Event's own marks from `metric_inputs` filled in, then its result. Keyed by metric, e.g. `propagation_potential`: \"(channel 0.1 + coupling 0.1 + breach 0 + primed 0.05 + (1 − containment 0.7)) / 5 = 0.11\". `=` is exact. Where the exact value has more than two decimals the line shows it, then `→` the score, which is that value rounded to two decimals in binary floating point as stored, so an exact half can round down: \"(claim_exposure 0.15 + economic_bite 0.2) / 2 = 0.175 → 0.17\". A value that does not end within six decimals is cut to four and marked \"…\". A score a gate set to 0, or left NULL because the article gave no observable, states why instead: \"claim_exposure 0 ≤ 0.05 → nothing traded is exposed → 0\". A line is served only when it reproduces the score served beside it, so a metric's line is OMITTED, never approximated, when its marks are missing or the row predates the published formulas (see `metric_version`). `significance` has no line. Formulas: https://docs.gdeltcloud.com/reference/metrics","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic","typeLabel":"object"},"metric_version":{"type":"string","description":"The scoring version of a CAMEO+ event's metrics. Absent on conflict events, which have no sub-factor metrics, and on CAMEO+ events scored before versions were recorded.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.metric_version","typeLabel":"string"},"observation_count":{"oneOf":[{"type":"number","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.observation_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.observation_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.observation_count","typeLabel":"number | null"},"prominence":{"oneOf":[{"type":"number","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.prominence.oneOf.0","typeLabel":"number"},{"type":"null","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.prominence.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics.prominence","typeLabel":"number | null"}},"required":["significance","severity_tier","goldstein_scale","magnitude","systemic_importance","propagation_potential","market_sensitivity","confidence","article_count","evidence_source_count","supporting_story_count"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].metrics","typeLabel":"object"},"has_fatalities":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].has_fatalities.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].has_fatalities.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].has_fatalities","typeLabel":"boolean | null"},"fatalities":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities","typeLabel":"number | null"},"fatalities_basis":{"oneOf":[{"type":"string","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_basis.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_basis.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_basis","typeLabel":"enum\u003cstring> | null"},"fatalities_corroboration":{"oneOf":[{"type":"string","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_corroboration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_corroboration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_corroboration","typeLabel":"enum\u003cstring> | null"},"fatalities_evidence":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_evidence.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_evidence","typeLabel":"string | null"},"fatalities_supporting_source_count":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_supporting_source_count.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_supporting_source_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].fatalities_supporting_source_count","typeLabel":"number | null"},"injured":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].injured.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].injured.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].injured","typeLabel":"number | null"},"civilians_killed":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilians_killed.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilians_killed.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilians_killed","typeLabel":"number | null"},"civilians_injured":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilians_injured.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilians_injured.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilians_injured","typeLabel":"number | null"},"civilian_targeting":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilian_targeting.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilian_targeting.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilian_targeting","typeLabel":"boolean | null"},"civilian_targeting_label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilian_targeting_label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilian_targeting_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].civilian_targeting_label","typeLabel":"string | null"},"story_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].id","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].url","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].title","typeLabel":"string | null"},"story_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].story_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].story_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].story_date","typeLabel":"string | null"},"article_count":{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].article_count","typeLabel":"number"}},"required":["id","url","title","story_date","article_count"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_refs","typeLabel":"object[]"},"entity_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].name","typeLabel":"string"},"source_entity_ids":{"type":"array","items":{"type":"string","uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].source_entity_ids.items.[INDEX]","typeLabel":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].source_entity_ids","typeLabel":"string[]"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.checked","typeLabel":"boolean"},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.is_public_official.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.is_public_official.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.is_public_official","typeLabel":"boolean | null"},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.status","typeLabel":"enum\u003cstring> | null"},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.total.oneOf.0","typeLabel":"number"},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.total","typeLabel":"number | null"},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].office_id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].name","typeLabel":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.0","typeLabel":"string"},{"type":"null","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].country_iso3","typeLabel":"string | null"},"status":{"type":"string","enum":["current","ended","unknown"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"start_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].start_date","typeLabel":"string | null"},"end_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].end_date","typeLabel":"string | null"},"evidence_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].evidence_date","typeLabel":"string | null"},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].source_key","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url","typeLabel":"string | null"}},"required":["source_key","url"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources","typeLabel":"object[]"}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices","typeLabel":"object[]"},"truncated":{"type":"boolean","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.truncated","typeLabel":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official","typeLabel":"object"}},"required":["id","name"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_refs","typeLabel":"object[]"},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].url","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain","typeLabel":"string | null"},"domain_avatar_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain_avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain_avatar_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain_avatar_url","typeLabel":"string | null"},"rank":{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].rank","typeLabel":"number"}},"required":["url","title","domain","domain_avatar_url","rank"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_articles","typeLabel":"object[]"},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].language","typeLabel":"string"},"count":{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].count","typeLabel":"number"}},"required":["language","count"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].language_breakdown","typeLabel":"object[]"},"top_language":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_language.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_language.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].top_language","typeLabel":"string | null"},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].search_score.oneOf.0","typeLabel":"number"},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].search_score.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].search_score","typeLabel":"number | null"},"incident":{"type":"object","properties":{"uid":{"type":"string","description":"The incident key. Group or `uniqExact` on this instead of `event_uid` to count INCIDENTS rather than coded stories. Equal to `event_uid` unless a judge confirmed this event duplicates another, in which case it is the surviving event of the group. ALWAYS read `resolution` before trusting it: on an `unadjudicated` row this value is a fallback, not a verdict.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].incident.uid","typeLabel":"string"},"resolution":{"type":"string","enum":["unadjudicated","self","llm"],"description":"How `uid` was decided. `unadjudicated` — this event was never compared to anything, and `uid` defaults to `event_uid`. `self` — compared and found unique. `llm` — an independent adversarial judge confirmed a duplicate and `uid` names the survivor. Coverage is deliberately partial and visible: only events that were candidates for a duplicate are ever adjudicated.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].incident.resolution","typeLabel":"enum\u003cstring>"},"confidence":{"oneOf":[{"type":"number","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].incident.confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].incident.confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].incident.confidence","typeLabel":"number | null"}},"required":["uid","resolution","confidence"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].incident","typeLabel":"object"},"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].recorded_at","typeLabel":"string"},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].published_at","typeLabel":"string"},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.recent_count","typeLabel":"number"},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count","typeLabel":"number | null"},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count","typeLabel":"number | null"},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.0","typeLabel":"number"},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.change","typeLabel":"number | null"},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.score","typeLabel":"number"},"recent_start":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.recent_start","typeLabel":"string"},"recent_end":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.recent_end","typeLabel":"string"},"baseline_start":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_start","typeLabel":"string"},"baseline_end":{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_end","typeLabel":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].rising","typeLabel":"object | null"},"spread":{"type":"object","properties":{"story_id":{"oneOf":[{"type":"string","description":"The primary Story whose reach ranks the Event.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].spread.story_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The primary Story whose reach ranks the Event.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].spread.story_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].spread.story_id","typeLabel":"string | null"},"outlets":{"type":"number","description":"Distinct outlets that reported that Story.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].spread.outlets","typeLabel":"number"},"first_of_story":{"type":"boolean","description":"True for the Story's most prominent Event, which ranks before the Story's other Events.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].spread.first_of_story","typeLabel":"boolean"}},"required":["story_id","outlets","first_of_story"],"description":"Only with sort=spread.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].spread","typeLabel":"object"},"story_date":{"type":"string","uniqueKey":"owner_events.oneOf.0.items.[INDEX].story_date","typeLabel":"string"},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].match_type","typeLabel":"enum\u003cstring>"},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.entity","typeLabel":"string"},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.mode","typeLabel":"enum\u003cstring>"},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.via","typeLabel":"enum\u003cstring>"},"role":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.role.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.role.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.role","typeLabel":"string | null"},"decision":{"type":"string","enum":["coverage"],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.decision","typeLabel":"enum\u003cstring>"},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.materiality_confidence","typeLabel":"number | null"},"resolution_confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.resolution_confidence","typeLabel":"number | null"},"resolution_method":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.resolution_method","typeLabel":"string | null"},"evidence":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.evidence","typeLabel":"null"},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it.","isRequired":true,"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.story_date","typeLabel":"string"},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id.","uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link.story_id","typeLabel":"string"}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX].entity_link","typeLabel":"object"}},"required":["id","url","primary_story_url","family","title","title_source","summary","event_date","observed_at","event_date_basis","event_date_evidence","coded_at","updated_at","processed_at","category","subcategory","subcategory_label","event_description","taxonomy_status","domain","event_code","geo","geo_context","actors","metrics","has_fatalities","fatalities","fatalities_basis","fatalities_corroboration","fatalities_evidence","fatalities_supporting_source_count","injured","civilians_killed","civilians_injured","civilian_targeting","civilian_targeting_label","story_refs","entity_refs","top_articles","language_breakdown","top_language","search_score","incident"],"uniqueKey":"owner_events.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Bounded reporting about owners and recorded parents; not events at the site. Null means unmeasured.","isRequired":true,"uniqueKey":"owner_events.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries."},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries."},"id":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]},"primary_story_url":{"oneOf":[{"type":"string"},{"type":"null"}]},"family":{"type":"string","enum":["conflict","cameoplus"]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"title_source":{"type":"string","enum":["coder_title","cluster_label","event_description","actor_pair","actor","sub_event_type","event_type_in_location","event_type","domain_in_location","domain","fallback"]},"summary":{"oneOf":[{"type":"string"},{"type":"null"}]},"event_date":{"type":"string"},"observed_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"event_date_basis":{"oneOf":[{"type":"string","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"]},{"type":"null","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"]}]},"event_date_evidence":{"oneOf":[{"type":"string"},{"type":"null"}]},"coded_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"processed_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"category":{"oneOf":[{"type":"string"},{"type":"null"}]},"subcategory":{"oneOf":[{"type":"string","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`."},{"type":"null","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`."}]},"subcategory_label":{"oneOf":[{"type":"string","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`."},{"type":"null","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`."}]},"event_description":{"oneOf":[{"type":"string","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`."},{"type":"null","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`."}]},"taxonomy_status":{"type":"string","enum":["coded","detail_missing","undeclared_code"]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"event_code":{"oneOf":[{"type":"string"},{"type":"null"}]},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"region":{"oneOf":[{"type":"string"},{"type":"null"}]},"continent":{"oneOf":[{"type":"string"},{"type":"null"}]},"admin1":{"oneOf":[{"type":"string"},{"type":"null"}]},"location":{"oneOf":[{"type":"string"},{"type":"null"}]},"latitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"longitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision_label":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"]},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string"},{"type":"null"}]},"actor_origin_countries":{"type":"array","items":{"type":"string"}}},"required":["location_country","actor_origin_countries"]},"actors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"role":{"type":"string","enum":["source","target","actor1","actor2"],"description":"The part this actor played. CAMEO+ events are directed: `source` acted, `target` was acted upon. Conflict (ACLED) events are undirected and use `actor1`/`actor2`, which imply no initiator. The two pairs never mix on one card — `family` determines which you get."},"primary":{"type":"boolean","description":"True for the coder's PRIMARY actor in this role — the one entity the event is chiefly about on that side, and the one carried in the `source_actor` / `target_actor` columns and filters. False for a co-actor: another entity in the same role in the same action. `actors[]` is ordered primaries-first, and there is at most one `primary: true` per role."},"source_entity_id":{"type":"string","description":"Original actor handle before published canonical identity resolution; actor role is retained."},"entity_id":{"type":"string","description":"In Event responses and facility context previews, an unambiguous identity for this actor, referencing entity_refs. Added through existing identity evidence or a unique exact name/alias lookup; absent for unresolved or conflicting identities."}},"required":["name","country","role","primary"]}},"metrics":{"type":"object","properties":{"significance":{"type":"number"},"severity_tier":{"type":"string","description":"A severity label from reported deaths, civilian targeting and intensity. It is not a band of `significance`, and nothing sorts or filters on it. `critical`: 10 or more deaths, or 3 or more with civilians targeted. `high`: 3 to 9 deaths, or 1 or 2 with civilians targeted. `medium`: 1 or 2 deaths; civilians targeted with no deaths reported; or `magnitude` of 7 or more, or `systemic_importance` of 0.7 or more. `low`: everything else. Deaths and civilian targeting are coded on conflict events only, so a CAMEO+ event is `medium` at most."},"goldstein_scale":{"oneOf":[{"type":"number","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined."},{"type":"null","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined."}]},"magnitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"systemic_importance":{"oneOf":[{"type":"number"},{"type":"null"}]},"propagation_potential":{"oneOf":[{"type":"number"},{"type":"null"}]},"market_sensitivity":{"oneOf":[{"type":"number"},{"type":"null"}]},"confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"article_count":{"oneOf":[{"type":"number","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count."},{"type":"null","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count."}]},"evidence_source_count":{"type":"number","description":"Distinct source URLs attached directly to the Event evidence."},"supporting_story_count":{"type":"number","description":"Number of canonical Story references attached to the Event."},"metric_inputs":{"description":"The EVIDENCE BEHIND THE SCORES — for each metric, the sub-factor values the coder read off the article and the reason it gave for each, keyed by metric. This is what makes a metric auditable rather than something to trust: the published formula turns these inputs into the served value, so you can recompute it yourself. Keyed `magnitude`, `systemic`, `propagation` and `market`; each sub-factor is `{value, why}`, beside descriptive keys such as `node`, and `magnitude` carries its `path`, `value` and `why` directly. Present on most CAMEO+ events; OMITTED where no sub-factor evidence was recorded, which is not the same as none existing — events coded before the field was stored carry nothing, and a backfill has not run. Sub-factor definitions and the formulas: https://docs.gdeltcloud.com/reference/metrics"},"metric_arithmetic":{"type":"object","properties":{"magnitude":{"type":"string"},"systemic_importance":{"type":"string"},"propagation_potential":{"type":"string"},"market_sensitivity":{"type":"string"}},"description":"The ARITHMETIC behind each scaled score: its published formula with this Event's own marks from `metric_inputs` filled in, then its result. Keyed by metric, e.g. `propagation_potential`: \"(channel 0.1 + coupling 0.1 + breach 0 + primed 0.05 + (1 − containment 0.7)) / 5 = 0.11\". `=` is exact. Where the exact value has more than two decimals the line shows it, then `→` the score, which is that value rounded to two decimals in binary floating point as stored, so an exact half can round down: \"(claim_exposure 0.15 + economic_bite 0.2) / 2 = 0.175 → 0.17\". A value that does not end within six decimals is cut to four and marked \"…\". A score a gate set to 0, or left NULL because the article gave no observable, states why instead: \"claim_exposure 0 ≤ 0.05 → nothing traded is exposed → 0\". A line is served only when it reproduces the score served beside it, so a metric's line is OMITTED, never approximated, when its marks are missing or the row predates the published formulas (see `metric_version`). `significance` has no line. Formulas: https://docs.gdeltcloud.com/reference/metrics"},"metric_version":{"type":"string","description":"The scoring version of a CAMEO+ event's metrics. Absent on conflict events, which have no sub-factor metrics, and on CAMEO+ events scored before versions were recorded."},"observation_count":{"oneOf":[{"type":"number","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it."},{"type":"null","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it."}]},"prominence":{"oneOf":[{"type":"number","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count."},{"type":"null","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count."}]}},"required":["significance","severity_tier","goldstein_scale","magnitude","systemic_importance","propagation_potential","market_sensitivity","confidence","article_count","evidence_source_count","supporting_story_count"]},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor."},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor."}]},"spread":{"type":"object","properties":{"story_id":{"oneOf":[{"type":"string","description":"The primary Story whose reach ranks the Event."},{"type":"null","description":"The primary Story whose reach ranks the Event."}]},"outlets":{"type":"number","description":"Distinct outlets that reported that Story."},"first_of_story":{"type":"boolean","description":"True for the Story's most prominent Event, which ranks before the Story's other Events."}},"required":["story_id","outlets","first_of_story"],"description":"Only with sort=spread."},"has_fatalities":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"fatalities":{"oneOf":[{"type":"number"},{"type":"null"}]},"fatalities_basis":{"oneOf":[{"type":"string","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"]},{"type":"null","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"]}]},"fatalities_corroboration":{"oneOf":[{"type":"string","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"]},{"type":"null","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"]}]},"fatalities_evidence":{"oneOf":[{"type":"string"},{"type":"null"}]},"fatalities_supporting_source_count":{"oneOf":[{"type":"number"},{"type":"null"}]},"injured":{"oneOf":[{"type":"number"},{"type":"null"}]},"civilians_killed":{"oneOf":[{"type":"number"},{"type":"null"}]},"civilians_injured":{"oneOf":[{"type":"number"},{"type":"null"}]},"civilian_targeting":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"civilian_targeting_label":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"article_count":{"type":"number"}},"required":["id","url","title","story_date","article_count"]}},"entity_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]}},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain_avatar_url":{"oneOf":[{"type":"string"},{"type":"null"}]},"rank":{"type":"number"}},"required":["url","title","domain","domain_avatar_url","rank"]}},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string"},"count":{"type":"number"}},"required":["language","count"]}},"top_language":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_date":{"type":"string"},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one."},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one."}]},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests."},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered."},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity."},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder."},"role":{"oneOf":[{"type":"string"},{"type":"null"}]},"decision":{"type":"string","enum":["coverage"]},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching."},{"type":"null","description":"Reserved; null for coverage matching."}]},"resolution_confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"resolution_method":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence":{"oneOf":[{},{"type":"null"}]},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id."},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it."}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"]},"incident":{"type":"object","properties":{"uid":{"type":"string","description":"The incident key. Group or `uniqExact` on this instead of `event_uid` to count INCIDENTS rather than coded stories. Equal to `event_uid` unless a judge confirmed this event duplicates another, in which case it is the surviving event of the group. ALWAYS read `resolution` before trusting it: on an `unadjudicated` row this value is a fallback, not a verdict."},"resolution":{"type":"string","enum":["unadjudicated","self","llm"],"description":"How `uid` was decided. `unadjudicated` — this event was never compared to anything, and `uid` defaults to `event_uid`. `self` — compared and found unique. `llm` — an independent adversarial judge confirmed a duplicate and `uid` names the survivor. Coverage is deliberately partial and visible: only events that were candidates for a duplicate are ever adjudicated."},"confidence":{"oneOf":[{"type":"number","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge."},{"type":"null","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge."}]}},"required":["uid","resolution","confidence"]}},"required":["id","url","primary_story_url","family","title","title_source","summary","event_date","observed_at","event_date_basis","event_date_evidence","coded_at","updated_at","processed_at","category","subcategory","subcategory_label","event_description","taxonomy_status","domain","event_code","geo","geo_context","actors","metrics","has_fatalities","fatalities","fatalities_basis","fatalities_corroboration","fatalities_evidence","fatalities_supporting_source_count","injured","civilians_killed","civilians_injured","civilian_targeting","civilian_targeting_label","story_refs","entity_refs","top_articles","language_breakdown","top_language","search_score","incident"]},"description":"Bounded reporting about owners and recorded parents; not events at the site. Null means unmeasured.","isRequired":true,"uniqueKey":"owner_events.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_events","typeLabel":"object[] | null"},"owner_stories":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].id","typeLabel":"string"},"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].recorded_at","typeLabel":"string"},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].published_at","typeLabel":"string"},"url":{"oneOf":[{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title","typeLabel":"string | null"},"story_date":{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].story_date","typeLabel":"string"},"updated_at":{"oneOf":[{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].updated_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].updated_at","typeLabel":"string | null"},"processed_at":{"oneOf":[{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].processed_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].processed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].processed_at","typeLabel":"string | null"},"category":{"oneOf":[{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].category.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].category.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].category","typeLabel":"string | null"},"category_code":{"oneOf":[{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].category_code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].category_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].category_code","typeLabel":"string | null"},"subcategory":{"oneOf":[{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].subcategory.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].subcategory.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].subcategory","typeLabel":"string | null"},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.country","typeLabel":"string | null"},"region":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.region.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.region.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.region","typeLabel":"string | null"},"continent":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.continent.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.continent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.continent","typeLabel":"string | null"},"admin1":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.admin1.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.admin1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.admin1","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.location.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.location","typeLabel":"string | null"},"latitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.latitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.latitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.longitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.longitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.longitude","typeLabel":"number | null"},"geo_precision":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.geo_precision","typeLabel":"number | null"},"geo_precision_label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo.geo_precision_label","typeLabel":"string | null"}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo","typeLabel":"object"},"geo_provenance":{"oneOf":[{"type":"object","properties":{"method":{"type":"string","enum":["representative_linked_event"],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.0.method","typeLabel":"enum\u003cstring>"},"event_id":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.0.event_id","typeLabel":"string"}},"required":["method","event_id"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"method":{"type":"string","enum":["representative_linked_event"]},"event_id":{"type":"string"}},"required":["method","event_id"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_provenance","typeLabel":"object | null"},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_context.location_country","typeLabel":"string | null"},"actor_origin_countries":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.oneOf.0.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries","typeLabel":"string[] | null"}},"required":["location_country","actor_origin_countries"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].geo_context","typeLabel":"object"},"metrics":{"type":"object","properties":{"significance":{"type":"number","description":"How widely the Story was reported: its article count on a log scale, min(1, ln(1 + article_count) / ln(10001)), rounded to four decimals. 1 article scores 0.0753, 100 articles 0.5011, 1,000 articles 0.7501, and 10,000 or more 1. Its Events' importance is `max_linked_event_significance`.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.significance","typeLabel":"number"},"article_count":{"type":"number","description":"Articles the Story holds. One page is counted more than once when it arrived under URLs that differ only in http or https, a leading `www.`, trailing slashes or tracking parameters such as `utm_*`; GET /api/v2/stories/{story_id}/articles lists each page once, so it can return fewer articles.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.article_count","typeLabel":"number"},"linked_event_count":{"oneOf":[{"type":"number","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.linked_event_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.linked_event_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.linked_event_count","typeLabel":"number | null"},"max_linked_event_significance":{"oneOf":[{"type":"number","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.max_linked_event_significance.oneOf.0","typeLabel":"number"},{"type":"null","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.max_linked_event_significance.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.max_linked_event_significance","typeLabel":"number | null"},"civilian_targeting_event_count":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.civilian_targeting_event_count.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.civilian_targeting_event_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.civilian_targeting_event_count","typeLabel":"number | null"},"outlet_count":{"oneOf":[{"type":"number","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.outlet_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.outlet_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics.outlet_count","typeLabel":"number | null"}},"required":["significance","article_count","linked_event_count","max_linked_event_significance","civilian_targeting_event_count"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].metrics","typeLabel":"object"},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.recent_count","typeLabel":"number"},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count","typeLabel":"number | null"},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count","typeLabel":"number | null"},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.0","typeLabel":"number"},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.change","typeLabel":"number | null"},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.score","typeLabel":"number"},"recent_start":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.recent_start","typeLabel":"string"},"recent_end":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.recent_end","typeLabel":"string"},"baseline_start":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_start","typeLabel":"string"},"baseline_end":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_end","typeLabel":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].rising","typeLabel":"object | null"},"event_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means linked-Event evidence could not be read; event-derived counts, flags and arrays are null, not measured zero or empty.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].event_enrichment_status","typeLabel":"enum\u003cstring>"},"entity_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means Story entity evidence was not published; entity_refs is null rather than misleadingly empty.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_enrichment_status","typeLabel":"enum\u003cstring>"},"has_events":{"oneOf":[{"type":"boolean","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].has_events.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].has_events.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].has_events","typeLabel":"boolean | null"},"has_fatalities":{"oneOf":[{"type":"boolean","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].has_fatalities.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].has_fatalities.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].has_fatalities","typeLabel":"boolean | null"},"has_civilian_targeting":{"oneOf":[{"type":"boolean","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].has_civilian_targeting.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].has_civilian_targeting.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].has_civilian_targeting","typeLabel":"boolean | null"},"fatalities":{"oneOf":[{"type":"number","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`).","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].fatalities.oneOf.0","typeLabel":"number"},{"type":"null","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`).","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].fatalities.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].fatalities","typeLabel":"number | null"},"linked_events":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].id","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].title","typeLabel":"string | null"}},"required":["id","title"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title"]},"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].linked_events","typeLabel":"object[] | null"},"entity_refs":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].name","typeLabel":"string"},"source_entity_ids":{"type":"array","items":{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].source_entity_ids.items.[INDEX]","typeLabel":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].source_entity_ids","typeLabel":"string[]"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.checked","typeLabel":"boolean"},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.is_public_official.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.is_public_official.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.is_public_official","typeLabel":"boolean | null"},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.status","typeLabel":"enum\u003cstring> | null"},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.total.oneOf.0","typeLabel":"number"},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.total","typeLabel":"number | null"},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].office_id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].name","typeLabel":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.0","typeLabel":"string"},{"type":"null","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].country_iso3","typeLabel":"string | null"},"status":{"type":"string","enum":["current","ended","unknown"],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"start_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].start_date","typeLabel":"string | null"},"end_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].end_date","typeLabel":"string | null"},"evidence_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].evidence_date","typeLabel":"string | null"},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].source_key","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url","typeLabel":"string | null"}},"required":["source_key","url"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources","typeLabel":"object[]"}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices","typeLabel":"object[]"},"truncated":{"type":"boolean","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.truncated","typeLabel":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official","typeLabel":"object"}},"required":["id","name"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]},"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_refs","typeLabel":"object[] | null"},"matched_categories":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0.items.[INDEX].code","typeLabel":"string"},"label":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0.items.[INDEX].label","typeLabel":"string"}},"required":["code","label"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]},"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].matched_categories","typeLabel":"object[] | null"},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].url","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain","typeLabel":"string | null"},"rank":{"type":"number","description":"Position in the Story's article ranking, 1 being the Story's anchor. GET /api/v2/stories/{story_id}/articles lists every article in the same ranking.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].rank","typeLabel":"number"}},"required":["url","title","domain","rank"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX]","typeLabel":"object"},"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_articles","typeLabel":"object[]"},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].language","typeLabel":"string"},"count":{"type":"number","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].count","typeLabel":"number"}},"required":["language","count"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX]","typeLabel":"object"},"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].language_breakdown","typeLabel":"object[]"},"top_language":{"oneOf":[{"type":"string","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_language.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_language.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].top_language","typeLabel":"string | null"},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.entity","typeLabel":"string"},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.mode","typeLabel":"enum\u003cstring>"},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.via","typeLabel":"enum\u003cstring>"},"role":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.role.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.role.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.role","typeLabel":"string | null"},"decision":{"type":"string","enum":["coverage"],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.decision","typeLabel":"enum\u003cstring>"},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.materiality_confidence","typeLabel":"number | null"},"resolution_confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_confidence","typeLabel":"number | null"},"resolution_method":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_method","typeLabel":"string | null"},"evidence":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.evidence","typeLabel":"null"},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.story_date","typeLabel":"string"},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link.story_id","typeLabel":"string"}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].entity_link","typeLabel":"object"},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].search_score.oneOf.0","typeLabel":"number"},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].search_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].search_score","typeLabel":"number | null"},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].match_type","typeLabel":"enum\u003cstring>"},"title_history":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].title","typeLabel":"string"},"previous_title":{"type":"string","description":"The title it replaced.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].previous_title","typeLabel":"string"},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC).","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].changed_at","typeLabel":"string"},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"article_count":{"type":"number","description":"Articles the Story held when the title changed.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].article_count","typeLabel":"number"}},"required":["title","previous_title","changed_at","reason","article_count"],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`."},"previous_title":{"type":"string","description":"The title it replaced."},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC)."},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story."},"article_count":{"type":"number","description":"Articles the Story held when the title changed."}},"required":["title","previous_title","changed_at","reason","article_count"]},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_stories.oneOf.0.items.[INDEX].title_history","typeLabel":"object[] | null"},"event_count":{"type":"number","uniqueKey":"owner_stories.oneOf.0.items.[INDEX].event_count","typeLabel":"number"}},"required":["id"],"description":"Story referenced by the returned Events, hydrated through the canonical Stories serving API with category, metrics and identity evidence when available. Not an exhaustive facility Story search.","uniqueKey":"owner_stories.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Stories referenced by the returned owner Events; not an exhaustive owner Story search.","isRequired":true,"uniqueKey":"owner_stories.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries."},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries."},"id":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_date":{"type":"string"},"updated_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"processed_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"category":{"oneOf":[{"type":"string"},{"type":"null"}]},"category_code":{"oneOf":[{"type":"string"},{"type":"null"}]},"subcategory":{"oneOf":[{"type":"string"},{"type":"null"}]},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"region":{"oneOf":[{"type":"string"},{"type":"null"}]},"continent":{"oneOf":[{"type":"string"},{"type":"null"}]},"admin1":{"oneOf":[{"type":"string"},{"type":"null"}]},"location":{"oneOf":[{"type":"string"},{"type":"null"}]},"latitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"longitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision_label":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"]},"geo_provenance":{"oneOf":[{"type":"object","properties":{"method":{"type":"string","enum":["representative_linked_event"]},"event_id":{"type":"string"}},"required":["method","event_id"]},{"type":"null","properties":{"method":{"type":"string","enum":["representative_linked_event"]},"event_id":{"type":"string"}},"required":["method","event_id"]}]},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string"},{"type":"null"}]},"actor_origin_countries":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}},"required":["location_country","actor_origin_countries"]},"metrics":{"type":"object","properties":{"significance":{"type":"number","description":"How widely the Story was reported: its article count on a log scale, min(1, ln(1 + article_count) / ln(10001)), rounded to four decimals. 1 article scores 0.0753, 100 articles 0.5011, 1,000 articles 0.7501, and 10,000 or more 1. Its Events' importance is `max_linked_event_significance`."},"article_count":{"type":"number","description":"Articles the Story holds. One page is counted more than once when it arrived under URLs that differ only in http or https, a leading `www.`, trailing slashes or tracking parameters such as `utm_*`; GET /api/v2/stories/{story_id}/articles lists each page once, so it can return fewer articles."},"linked_event_count":{"oneOf":[{"type":"number","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable."},{"type":"null","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable."}]},"max_linked_event_significance":{"oneOf":[{"type":"number","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable."},{"type":"null","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable."}]},"civilian_targeting_event_count":{"oneOf":[{"type":"number"},{"type":"null"}]},"outlet_count":{"oneOf":[{"type":"number","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it."},{"type":"null","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it."}]}},"required":["significance","article_count","linked_event_count","max_linked_event_significance","civilian_targeting_event_count"]},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor."},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor."}]},"event_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means linked-Event evidence could not be read; event-derived counts, flags and arrays are null, not measured zero or empty."},"entity_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means Story entity evidence was not published; entity_refs is null rather than misleadingly empty."},"has_events":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"has_fatalities":{"oneOf":[{"type":"boolean","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable."},{"type":"null","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable."}]},"has_civilian_targeting":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"fatalities":{"oneOf":[{"type":"number","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`)."},{"type":"null","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`)."}]},"linked_events":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title"]}},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title"]}}]},"entity_refs":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]}},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]}}]},"matched_categories":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]}},{"type":"null","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]}}]},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"rank":{"type":"number","description":"Position in the Story's article ranking, 1 being the Story's anchor. GET /api/v2/stories/{story_id}/articles lists every article in the same ranking."}},"required":["url","title","domain","rank"]}},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string"},"count":{"type":"number"}},"required":["language","count"]}},"top_language":{"oneOf":[{"type":"string"},{"type":"null"}]},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered."},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity."},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder."},"role":{"oneOf":[{"type":"string"},{"type":"null"}]},"decision":{"type":"string","enum":["coverage"]},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching."},{"type":"null","description":"Reserved; null for coverage matching."}]},"resolution_confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"resolution_method":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence":{"oneOf":[{},{"type":"null"}]},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id."},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it."}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"]},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match."},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match."}]},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests."},"title_history":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`."},"previous_title":{"type":"string","description":"The title it replaced."},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC)."},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story."},"article_count":{"type":"number","description":"Articles the Story held when the title changed."}},"required":["title","previous_title","changed_at","reason","article_count"]},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses."},{"type":"null","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`."},"previous_title":{"type":"string","description":"The title it replaced."},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC)."},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story."},"article_count":{"type":"number","description":"Articles the Story held when the title changed."}},"required":["title","previous_title","changed_at","reason","article_count"]},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses."}]},"event_count":{"type":"number"}},"required":["id"],"description":"Story referenced by the returned Events, hydrated through the canonical Stories serving API with category, metrics and identity evidence when available. Not an exhaustive facility Story search."},"description":"Stories referenced by the returned owner Events; not an exhaustive owner Story search.","isRequired":true,"uniqueKey":"owner_stories.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_stories","typeLabel":"object[] | null"},"owner_footprint":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"owner_footprint.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"owner_footprint","typeLabel":"null"},"summary":{"type":"object","properties":{"events":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"summary.events.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"summary.events.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"summary.events","typeLabel":"number | null"},"stories":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"summary.stories.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"summary.stories.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"summary.stories","typeLabel":"number | null"}},"required":["events","stories"],"description":"Counts of the returned owner preview, not all matches.","isRequired":true,"uniqueKey":"summary","typeLabel":"object"},"next_steps":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","isRequired":true,"uniqueKey":"next_steps.items.[INDEX].label","typeLabel":"string"},"url":{"type":"string","isRequired":true,"uniqueKey":"next_steps.items.[INDEX].url","typeLabel":"string"}},"required":["label","url"],"uniqueKey":"next_steps.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"next_steps","typeLabel":"object[]"},"meta":{"type":"object","properties":{"as_of":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"meta.as_of.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"meta.as_of.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.as_of","typeLabel":"string | null"},"time_semantics":{"oneOf":[{"isRequired":true}],"isRequired":true,"uniqueKey":"meta.time_semantics","typeLabel":"any"},"attributions":{"oneOf":[{"isRequired":true}],"isRequired":true,"uniqueKey":"meta.attributions","typeLabel":"any"},"disclaimer":{"type":"string","isRequired":true,"uniqueKey":"meta.disclaimer","typeLabel":"string"},"coverage_note":{"type":"string","isRequired":true,"uniqueKey":"meta.coverage_note","typeLabel":"string"},"coverage":{"type":"object","properties":{"basis":{"type":"string","enum":["owner_bridge"],"isRequired":true,"uniqueKey":"meta.coverage.basis","typeLabel":"enum\u003cstring>"},"owner_resolved":{"type":"boolean","isRequired":true,"uniqueKey":"meta.coverage.owner_resolved","typeLabel":"boolean"},"bridged":{"type":"boolean","isRequired":true,"uniqueKey":"meta.coverage.bridged","typeLabel":"boolean"},"events_measured":{"type":"boolean","isRequired":true,"uniqueKey":"meta.coverage.events_measured","typeLabel":"boolean"},"partial_owner_scope":{"type":"boolean","uniqueKey":"meta.coverage.partial_owner_scope","typeLabel":"boolean"},"reporting":{"oneOf":[{},{"type":"null","uniqueKey":"meta.coverage.reporting.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.coverage.reporting","typeLabel":"null"},"story_details":{"type":"object","properties":{"status":{"type":"string","enum":["available","partial","unavailable","empty"],"isRequired":true,"uniqueKey":"meta.coverage.story_details.status","typeLabel":"enum\u003cstring>"},"reporting":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"meta.coverage.story_details.reporting.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.coverage.story_details.reporting","typeLabel":"null"}},"required":["status","reporting"],"description":"Availability and exact serving coverage for the linked Story detail enrichment. Partial or unavailable retains minimal references rather than fabricating categories or identity evidence.","uniqueKey":"meta.coverage.story_details","typeLabel":"object"},"actor_entities":{"type":"object","properties":{"status":{"type":"string","enum":["available","partial"],"isRequired":true,"uniqueKey":"meta.coverage.actor_entities.status","typeLabel":"enum\u003cstring>"},"matched_actor_count":{"type":"number","isRequired":true,"uniqueKey":"meta.coverage.actor_entities.matched_actor_count","typeLabel":"number"},"unresolved_actor_count":{"type":"number","isRequired":true,"uniqueKey":"meta.coverage.actor_entities.unresolved_actor_count","typeLabel":"number"},"lookup_unavailable_count":{"type":"number","isRequired":true,"uniqueKey":"meta.coverage.actor_entities.lookup_unavailable_count","typeLabel":"number"},"truncated_actor_count":{"type":"number","isRequired":true,"uniqueKey":"meta.coverage.actor_entities.truncated_actor_count","typeLabel":"number"}},"required":["status","matched_actor_count","unresolved_actor_count","lookup_unavailable_count","truncated_actor_count"],"description":"Identity enrichment for actor names: existing Event references, unambiguous exact names on linked served Stories, then unique exact resolver matches for names that pass the shared proper-noun and generic-name checks. Matched, unresolved and unavailable counts describe actor occurrences; truncated_actor_count counts names omitted by the lookup bound. Unresolved names stay plain actors; failed or bounded lookups remain explicit.","uniqueKey":"meta.coverage.actor_entities","typeLabel":"object"}},"required":["basis","owner_resolved","bridged","events_measured"],"description":"Owner scope and exact reporting date coverage; unknown coverage remains null.","isRequired":true,"uniqueKey":"meta.coverage","typeLabel":"object"},"nearby_coverage":{"type":"object","properties":{"basis":{"type":"string","enum":["geographic_screen"],"isRequired":true,"uniqueKey":"meta.nearby_coverage.basis","typeLabel":"enum\u003cstring>"},"radius_km":{"type":"number","isRequired":true,"uniqueKey":"meta.nearby_coverage.radius_km","typeLabel":"number"},"window":{"type":"object","properties":{"date_start":{"type":"string","isRequired":true,"uniqueKey":"meta.nearby_coverage.window.date_start","typeLabel":"string"},"date_end":{"type":"string","isRequired":true,"uniqueKey":"meta.nearby_coverage.window.date_end","typeLabel":"string"}},"required":["date_start","date_end"],"isRequired":true,"uniqueKey":"meta.nearby_coverage.window","typeLabel":"object"},"geo_precision":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"meta.nearby_coverage.geo_precision.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"meta.nearby_coverage.geo_precision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.nearby_coverage.geo_precision","typeLabel":"string | null"},"geo_evidence":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"meta.nearby_coverage.geo_evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.nearby_coverage.geo_evidence","typeLabel":"null"},"note":{"type":"string","isRequired":true,"uniqueKey":"meta.nearby_coverage.note","typeLabel":"string"},"events_measured":{"type":"boolean","isRequired":true,"uniqueKey":"meta.nearby_coverage.events_measured","typeLabel":"boolean"},"reporting":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"meta.nearby_coverage.reporting.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.nearby_coverage.reporting","typeLabel":"null"},"reason":{"type":"string","uniqueKey":"meta.nearby_coverage.reason","typeLabel":"string"},"count_basis":{"type":"string","uniqueKey":"meta.nearby_coverage.count_basis","typeLabel":"string"},"story_details":{"type":"object","properties":{"status":{"type":"string","enum":["available","partial","unavailable","empty"],"isRequired":true,"uniqueKey":"meta.nearby_coverage.story_details.status","typeLabel":"enum\u003cstring>"},"reporting":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"meta.nearby_coverage.story_details.reporting.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.nearby_coverage.story_details.reporting","typeLabel":"null"}},"required":["status","reporting"],"description":"Availability and exact serving coverage for the linked Story detail enrichment. Partial or unavailable retains minimal references rather than fabricating categories or identity evidence.","uniqueKey":"meta.nearby_coverage.story_details","typeLabel":"object"},"actor_entities":{"type":"object","properties":{"status":{"type":"string","enum":["available","partial"],"isRequired":true,"uniqueKey":"meta.nearby_coverage.actor_entities.status","typeLabel":"enum\u003cstring>"},"matched_actor_count":{"type":"number","isRequired":true,"uniqueKey":"meta.nearby_coverage.actor_entities.matched_actor_count","typeLabel":"number"},"unresolved_actor_count":{"type":"number","isRequired":true,"uniqueKey":"meta.nearby_coverage.actor_entities.unresolved_actor_count","typeLabel":"number"},"lookup_unavailable_count":{"type":"number","isRequired":true,"uniqueKey":"meta.nearby_coverage.actor_entities.lookup_unavailable_count","typeLabel":"number"},"truncated_actor_count":{"type":"number","isRequired":true,"uniqueKey":"meta.nearby_coverage.actor_entities.truncated_actor_count","typeLabel":"number"}},"required":["status","matched_actor_count","unresolved_actor_count","lookup_unavailable_count","truncated_actor_count"],"description":"Identity enrichment for actor names: existing Event references, unambiguous exact names on linked served Stories, then unique exact resolver matches for names that pass the shared proper-noun and generic-name checks. Matched, unresolved and unavailable counts describe actor occurrences; truncated_actor_count counts names omitted by the lookup bound. Unresolved names stay plain actors; failed or bounded lookups remain explicit.","uniqueKey":"meta.nearby_coverage.actor_entities","typeLabel":"object"}},"required":["basis","radius_km","window","geo_precision","geo_evidence","note","events_measured","reporting"],"uniqueKey":"meta.nearby_coverage","typeLabel":"object"},"reported_owner_coverage":{"type":"object","properties":{"basis":{"type":"string","enum":["reported_owner_name"],"isRequired":true,"uniqueKey":"meta.reported_owner_coverage.basis","typeLabel":"enum\u003cstring>"},"events_measured":{"type":"boolean","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.events_measured","typeLabel":"boolean"},"entity_ids":{"type":"array","items":{"type":"string","uniqueKey":"meta.reported_owner_coverage.entity_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"meta.reported_owner_coverage.entity_ids","typeLabel":"string[]"},"window":{"type":"object","properties":{"date_start":{"type":"string","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.window.date_start","typeLabel":"string"},"date_end":{"type":"string","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.window.date_end","typeLabel":"string"}},"required":["date_start","date_end"],"isRequired":true,"uniqueKey":"meta.reported_owner_coverage.window","typeLabel":"object"},"reporting":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.reporting.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.reported_owner_coverage.reporting","typeLabel":"null"},"partial_name_scope":{"type":"boolean","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.partial_name_scope","typeLabel":"boolean"},"note":{"type":"string","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.note","typeLabel":"string"},"story_details":{"type":"object","properties":{"status":{"type":"string","enum":["available","partial","unavailable","empty"],"isRequired":true,"uniqueKey":"meta.reported_owner_coverage.story_details.status","typeLabel":"enum\u003cstring>"},"reporting":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.story_details.reporting.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"meta.reported_owner_coverage.story_details.reporting","typeLabel":"null"}},"required":["status","reporting"],"description":"Availability and exact serving coverage for the linked Story detail enrichment. Partial or unavailable retains minimal references rather than fabricating categories or identity evidence.","uniqueKey":"meta.reported_owner_coverage.story_details","typeLabel":"object"},"actor_entities":{"type":"object","properties":{"status":{"type":"string","enum":["available","partial"],"isRequired":true,"uniqueKey":"meta.reported_owner_coverage.actor_entities.status","typeLabel":"enum\u003cstring>"},"matched_actor_count":{"type":"number","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.actor_entities.matched_actor_count","typeLabel":"number"},"unresolved_actor_count":{"type":"number","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.actor_entities.unresolved_actor_count","typeLabel":"number"},"lookup_unavailable_count":{"type":"number","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.actor_entities.lookup_unavailable_count","typeLabel":"number"},"truncated_actor_count":{"type":"number","isRequired":true,"uniqueKey":"meta.reported_owner_coverage.actor_entities.truncated_actor_count","typeLabel":"number"}},"required":["status","matched_actor_count","unresolved_actor_count","lookup_unavailable_count","truncated_actor_count"],"description":"Identity enrichment for actor names: existing Event references, unambiguous exact names on linked served Stories, then unique exact resolver matches for names that pass the shared proper-noun and generic-name checks. Matched, unresolved and unavailable counts describe actor occurrences; truncated_actor_count counts names omitted by the lookup bound. Unresolved names stay plain actors; failed or bounded lookups remain explicit.","uniqueKey":"meta.reported_owner_coverage.actor_entities","typeLabel":"object"}},"required":["basis","events_measured","entity_ids","window","reporting","partial_name_scope","note"],"uniqueKey":"meta.reported_owner_coverage","typeLabel":"object"}},"required":["as_of","time_semantics","attributions","disclaimer","coverage_note","coverage"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"},"reported_owner_matches":{"type":"array","items":{"type":"object","properties":{"reported_name":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_matches.items.[INDEX].reported_name","typeLabel":"string"},"entity_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_matches.items.[INDEX].entity_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_matches.items.[INDEX].entity_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_matches.items.[INDEX].entity_id","typeLabel":"string | null"},"status":{"type":"string","enum":["matched","unmatched","ambiguous","unavailable"],"isRequired":true,"uniqueKey":"reported_owner_matches.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"name":{"type":"string","uniqueKey":"reported_owner_matches.items.[INDEX].name","typeLabel":"string"},"bridged":{"oneOf":[{"type":"boolean","uniqueKey":"reported_owner_matches.items.[INDEX].bridged.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"reported_owner_matches.items.[INDEX].bridged.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_matches.items.[INDEX].bridged","typeLabel":"boolean | null"},"basis":{"type":"string","enum":["exact_reference_name_or_alias"],"uniqueKey":"reported_owner_matches.items.[INDEX].basis","typeLabel":"enum\u003cstring>"},"match_type":{"type":"string","uniqueKey":"reported_owner_matches.items.[INDEX].match_type","typeLabel":"string"}},"required":["reported_name","entity_id","status"],"uniqueKey":"reported_owner_matches.items.[INDEX]","typeLabel":"object"},"description":"Exact reference-name identity discovery for name-only owners; does not verify facility ownership.","uniqueKey":"reported_owner_matches","typeLabel":"object[]"},"reported_owner_events":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].id","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"primary_story_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].primary_story_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].primary_story_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].primary_story_url","typeLabel":"string | null"},"family":{"type":"string","enum":["conflict","cameoplus"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].family","typeLabel":"enum\u003cstring>"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].title","typeLabel":"string | null"},"title_source":{"type":"string","enum":["coder_title","cluster_label","event_description","actor_pair","actor","sub_event_type","event_type_in_location","event_type","domain_in_location","domain","fallback"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].title_source","typeLabel":"enum\u003cstring>"},"summary":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].summary.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].summary.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].summary","typeLabel":"string | null"},"event_date":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_date","typeLabel":"string"},"observed_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].observed_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].observed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].observed_at","typeLabel":"string | null"},"event_date_basis":{"oneOf":[{"type":"string","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_date_basis.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_date_basis.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_date_basis","typeLabel":"enum\u003cstring> | null"},"event_date_evidence":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_date_evidence.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_date_evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_date_evidence","typeLabel":"string | null"},"coded_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].coded_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].coded_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].coded_at","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].updated_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].updated_at","typeLabel":"string | null"},"processed_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].processed_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].processed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].processed_at","typeLabel":"string | null"},"category":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].category.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].category.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].category","typeLabel":"string | null"},"subcategory":{"oneOf":[{"type":"string","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].subcategory.oneOf.0","typeLabel":"string"},{"type":"null","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].subcategory.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].subcategory","typeLabel":"string | null"},"subcategory_label":{"oneOf":[{"type":"string","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].subcategory_label.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].subcategory_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].subcategory_label","typeLabel":"string | null"},"event_description":{"oneOf":[{"type":"string","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_description.oneOf.0","typeLabel":"string"},{"type":"null","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_description","typeLabel":"string | null"},"taxonomy_status":{"type":"string","enum":["coded","detail_missing","undeclared_code"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].taxonomy_status","typeLabel":"enum\u003cstring>"},"domain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].domain","typeLabel":"string | null"},"event_code":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_code.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].event_code","typeLabel":"string | null"},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.country","typeLabel":"string | null"},"region":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.region.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.region.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.region","typeLabel":"string | null"},"continent":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.continent.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.continent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.continent","typeLabel":"string | null"},"admin1":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.admin1.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.admin1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.admin1","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.location.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.location","typeLabel":"string | null"},"latitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.latitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.latitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.longitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.longitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.longitude","typeLabel":"number | null"},"geo_precision":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.geo_precision","typeLabel":"number | null"},"geo_precision_label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo.geo_precision_label","typeLabel":"string | null"}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo","typeLabel":"object"},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo_context.location_country","typeLabel":"string | null"},"actor_origin_countries":{"type":"array","items":{"type":"string","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo_context.actor_origin_countries","typeLabel":"string[]"}},"required":["location_country","actor_origin_countries"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].geo_context","typeLabel":"object"},"actors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].name","typeLabel":"string"},"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].country","typeLabel":"string | null"},"role":{"type":"string","enum":["source","target","actor1","actor2"],"description":"The part this actor played. CAMEO+ events are directed: `source` acted, `target` was acted upon. Conflict (ACLED) events are undirected and use `actor1`/`actor2`, which imply no initiator. The two pairs never mix on one card — `family` determines which you get.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"primary":{"type":"boolean","description":"True for the coder's PRIMARY actor in this role — the one entity the event is chiefly about on that side, and the one carried in the `source_actor` / `target_actor` columns and filters. False for a co-actor: another entity in the same role in the same action. `actors[]` is ordered primaries-first, and there is at most one `primary: true` per role.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].primary","typeLabel":"boolean"},"source_entity_id":{"type":"string","description":"Original actor handle before published canonical identity resolution; actor role is retained.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].source_entity_id","typeLabel":"string"},"entity_id":{"type":"string","description":"In Event responses and facility context previews, an unambiguous identity for this actor, referencing entity_refs. Added through existing identity evidence or a unique exact name/alias lookup; absent for unresolved or conflicting identities.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX].entity_id","typeLabel":"string"}},"required":["name","country","role","primary"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].actors","typeLabel":"object[]"},"metrics":{"type":"object","properties":{"significance":{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.significance","typeLabel":"number"},"severity_tier":{"type":"string","description":"A severity label from reported deaths, civilian targeting and intensity. It is not a band of `significance`, and nothing sorts or filters on it. `critical`: 10 or more deaths, or 3 or more with civilians targeted. `high`: 3 to 9 deaths, or 1 or 2 with civilians targeted. `medium`: 1 or 2 deaths; civilians targeted with no deaths reported; or `magnitude` of 7 or more, or `systemic_importance` of 0.7 or more. `low`: everything else. Deaths and civilian targeting are coded on conflict events only, so a CAMEO+ event is `medium` at most.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.severity_tier","typeLabel":"string"},"goldstein_scale":{"oneOf":[{"type":"number","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.goldstein_scale.oneOf.0","typeLabel":"number"},{"type":"null","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.goldstein_scale.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.goldstein_scale","typeLabel":"number | null"},"magnitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.magnitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.magnitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.magnitude","typeLabel":"number | null"},"systemic_importance":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.systemic_importance.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.systemic_importance.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.systemic_importance","typeLabel":"number | null"},"propagation_potential":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.propagation_potential.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.propagation_potential.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.propagation_potential","typeLabel":"number | null"},"market_sensitivity":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.market_sensitivity.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.market_sensitivity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.market_sensitivity","typeLabel":"number | null"},"confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.confidence","typeLabel":"number | null"},"article_count":{"oneOf":[{"type":"number","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.article_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.article_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.article_count","typeLabel":"number | null"},"evidence_source_count":{"type":"number","description":"Distinct source URLs attached directly to the Event evidence.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.evidence_source_count","typeLabel":"number"},"supporting_story_count":{"type":"number","description":"Number of canonical Story references attached to the Event.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.supporting_story_count","typeLabel":"number"},"metric_inputs":{"description":"The EVIDENCE BEHIND THE SCORES — for each metric, the sub-factor values the coder read off the article and the reason it gave for each, keyed by metric. This is what makes a metric auditable rather than something to trust: the published formula turns these inputs into the served value, so you can recompute it yourself. Keyed `magnitude`, `systemic`, `propagation` and `market`; each sub-factor is `{value, why}`, beside descriptive keys such as `node`, and `magnitude` carries its `path`, `value` and `why` directly. Present on most CAMEO+ events; OMITTED where no sub-factor evidence was recorded, which is not the same as none existing — events coded before the field was stored carry nothing, and a backfill has not run. Sub-factor definitions and the formulas: https://docs.gdeltcloud.com/reference/metrics","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.metric_inputs","typeLabel":"any"},"metric_arithmetic":{"type":"object","properties":{"magnitude":{"type":"string","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.magnitude","typeLabel":"string"},"systemic_importance":{"type":"string","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.systemic_importance","typeLabel":"string"},"propagation_potential":{"type":"string","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.propagation_potential","typeLabel":"string"},"market_sensitivity":{"type":"string","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.market_sensitivity","typeLabel":"string"}},"description":"The ARITHMETIC behind each scaled score: its published formula with this Event's own marks from `metric_inputs` filled in, then its result. Keyed by metric, e.g. `propagation_potential`: \"(channel 0.1 + coupling 0.1 + breach 0 + primed 0.05 + (1 − containment 0.7)) / 5 = 0.11\". `=` is exact. Where the exact value has more than two decimals the line shows it, then `→` the score, which is that value rounded to two decimals in binary floating point as stored, so an exact half can round down: \"(claim_exposure 0.15 + economic_bite 0.2) / 2 = 0.175 → 0.17\". A value that does not end within six decimals is cut to four and marked \"…\". A score a gate set to 0, or left NULL because the article gave no observable, states why instead: \"claim_exposure 0 ≤ 0.05 → nothing traded is exposed → 0\". A line is served only when it reproduces the score served beside it, so a metric's line is OMITTED, never approximated, when its marks are missing or the row predates the published formulas (see `metric_version`). `significance` has no line. Formulas: https://docs.gdeltcloud.com/reference/metrics","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic","typeLabel":"object"},"metric_version":{"type":"string","description":"The scoring version of a CAMEO+ event's metrics. Absent on conflict events, which have no sub-factor metrics, and on CAMEO+ events scored before versions were recorded.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.metric_version","typeLabel":"string"},"observation_count":{"oneOf":[{"type":"number","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.observation_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.observation_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.observation_count","typeLabel":"number | null"},"prominence":{"oneOf":[{"type":"number","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.prominence.oneOf.0","typeLabel":"number"},{"type":"null","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.prominence.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics.prominence","typeLabel":"number | null"}},"required":["significance","severity_tier","goldstein_scale","magnitude","systemic_importance","propagation_potential","market_sensitivity","confidence","article_count","evidence_source_count","supporting_story_count"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].metrics","typeLabel":"object"},"has_fatalities":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].has_fatalities.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].has_fatalities.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].has_fatalities","typeLabel":"boolean | null"},"fatalities":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities","typeLabel":"number | null"},"fatalities_basis":{"oneOf":[{"type":"string","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_basis.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_basis.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_basis","typeLabel":"enum\u003cstring> | null"},"fatalities_corroboration":{"oneOf":[{"type":"string","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_corroboration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_corroboration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_corroboration","typeLabel":"enum\u003cstring> | null"},"fatalities_evidence":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_evidence.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_evidence","typeLabel":"string | null"},"fatalities_supporting_source_count":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_supporting_source_count.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_supporting_source_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].fatalities_supporting_source_count","typeLabel":"number | null"},"injured":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].injured.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].injured.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].injured","typeLabel":"number | null"},"civilians_killed":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilians_killed.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilians_killed.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilians_killed","typeLabel":"number | null"},"civilians_injured":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilians_injured.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilians_injured.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilians_injured","typeLabel":"number | null"},"civilian_targeting":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilian_targeting.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilian_targeting.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilian_targeting","typeLabel":"boolean | null"},"civilian_targeting_label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilian_targeting_label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilian_targeting_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].civilian_targeting_label","typeLabel":"string | null"},"story_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].id","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].url","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].title","typeLabel":"string | null"},"story_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].story_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].story_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].story_date","typeLabel":"string | null"},"article_count":{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].article_count","typeLabel":"number"}},"required":["id","url","title","story_date","article_count"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_refs","typeLabel":"object[]"},"entity_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].name","typeLabel":"string"},"source_entity_ids":{"type":"array","items":{"type":"string","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].source_entity_ids.items.[INDEX]","typeLabel":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].source_entity_ids","typeLabel":"string[]"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.checked","typeLabel":"boolean"},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.is_public_official.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.is_public_official.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.is_public_official","typeLabel":"boolean | null"},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.status","typeLabel":"enum\u003cstring> | null"},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.total.oneOf.0","typeLabel":"number"},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.total","typeLabel":"number | null"},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].office_id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].name","typeLabel":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.0","typeLabel":"string"},{"type":"null","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].country_iso3","typeLabel":"string | null"},"status":{"type":"string","enum":["current","ended","unknown"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"start_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].start_date","typeLabel":"string | null"},"end_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].end_date","typeLabel":"string | null"},"evidence_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].evidence_date","typeLabel":"string | null"},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].source_key","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url","typeLabel":"string | null"}},"required":["source_key","url"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources","typeLabel":"object[]"}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices","typeLabel":"object[]"},"truncated":{"type":"boolean","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.truncated","typeLabel":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official","typeLabel":"object"}},"required":["id","name"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_refs","typeLabel":"object[]"},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].url","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain","typeLabel":"string | null"},"domain_avatar_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain_avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain_avatar_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain_avatar_url","typeLabel":"string | null"},"rank":{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].rank","typeLabel":"number"}},"required":["url","title","domain","domain_avatar_url","rank"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_articles","typeLabel":"object[]"},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].language","typeLabel":"string"},"count":{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].count","typeLabel":"number"}},"required":["language","count"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].language_breakdown","typeLabel":"object[]"},"top_language":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_language.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_language.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].top_language","typeLabel":"string | null"},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].search_score.oneOf.0","typeLabel":"number"},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].search_score.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].search_score","typeLabel":"number | null"},"incident":{"type":"object","properties":{"uid":{"type":"string","description":"The incident key. Group or `uniqExact` on this instead of `event_uid` to count INCIDENTS rather than coded stories. Equal to `event_uid` unless a judge confirmed this event duplicates another, in which case it is the surviving event of the group. ALWAYS read `resolution` before trusting it: on an `unadjudicated` row this value is a fallback, not a verdict.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].incident.uid","typeLabel":"string"},"resolution":{"type":"string","enum":["unadjudicated","self","llm"],"description":"How `uid` was decided. `unadjudicated` — this event was never compared to anything, and `uid` defaults to `event_uid`. `self` — compared and found unique. `llm` — an independent adversarial judge confirmed a duplicate and `uid` names the survivor. Coverage is deliberately partial and visible: only events that were candidates for a duplicate are ever adjudicated.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].incident.resolution","typeLabel":"enum\u003cstring>"},"confidence":{"oneOf":[{"type":"number","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].incident.confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].incident.confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].incident.confidence","typeLabel":"number | null"}},"required":["uid","resolution","confidence"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].incident","typeLabel":"object"},"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].recorded_at","typeLabel":"string"},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].published_at","typeLabel":"string"},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.recent_count","typeLabel":"number"},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count","typeLabel":"number | null"},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count","typeLabel":"number | null"},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.0","typeLabel":"number"},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.change","typeLabel":"number | null"},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.score","typeLabel":"number"},"recent_start":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.recent_start","typeLabel":"string"},"recent_end":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.recent_end","typeLabel":"string"},"baseline_start":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_start","typeLabel":"string"},"baseline_end":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_end","typeLabel":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].rising","typeLabel":"object | null"},"spread":{"type":"object","properties":{"story_id":{"oneOf":[{"type":"string","description":"The primary Story whose reach ranks the Event.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].spread.story_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The primary Story whose reach ranks the Event.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].spread.story_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].spread.story_id","typeLabel":"string | null"},"outlets":{"type":"number","description":"Distinct outlets that reported that Story.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].spread.outlets","typeLabel":"number"},"first_of_story":{"type":"boolean","description":"True for the Story's most prominent Event, which ranks before the Story's other Events.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].spread.first_of_story","typeLabel":"boolean"}},"required":["story_id","outlets","first_of_story"],"description":"Only with sort=spread.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].spread","typeLabel":"object"},"story_date":{"type":"string","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].story_date","typeLabel":"string"},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].match_type","typeLabel":"enum\u003cstring>"},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.entity","typeLabel":"string"},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.mode","typeLabel":"enum\u003cstring>"},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.via","typeLabel":"enum\u003cstring>"},"role":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.role.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.role.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.role","typeLabel":"string | null"},"decision":{"type":"string","enum":["coverage"],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.decision","typeLabel":"enum\u003cstring>"},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.materiality_confidence","typeLabel":"number | null"},"resolution_confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.resolution_confidence","typeLabel":"number | null"},"resolution_method":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.resolution_method","typeLabel":"string | null"},"evidence":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.evidence","typeLabel":"null"},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it.","isRequired":true,"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.story_date","typeLabel":"string"},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id.","uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link.story_id","typeLabel":"string"}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX].entity_link","typeLabel":"object"}},"required":["id","url","primary_story_url","family","title","title_source","summary","event_date","observed_at","event_date_basis","event_date_evidence","coded_at","updated_at","processed_at","category","subcategory","subcategory_label","event_description","taxonomy_status","domain","event_code","geo","geo_context","actors","metrics","has_fatalities","fatalities","fatalities_basis","fatalities_corroboration","fatalities_evidence","fatalities_supporting_source_count","injured","civilians_killed","civilians_injured","civilian_targeting","civilian_targeting_label","story_refs","entity_refs","top_articles","language_breakdown","top_language","search_score","incident"],"uniqueKey":"reported_owner_events.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Separate best-effort reporting for exact reported-name matches; never promoted to resolved owner_events.","uniqueKey":"reported_owner_events.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries."},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries."},"id":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]},"primary_story_url":{"oneOf":[{"type":"string"},{"type":"null"}]},"family":{"type":"string","enum":["conflict","cameoplus"]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"title_source":{"type":"string","enum":["coder_title","cluster_label","event_description","actor_pair","actor","sub_event_type","event_type_in_location","event_type","domain_in_location","domain","fallback"]},"summary":{"oneOf":[{"type":"string"},{"type":"null"}]},"event_date":{"type":"string"},"observed_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"event_date_basis":{"oneOf":[{"type":"string","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"]},{"type":"null","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"]}]},"event_date_evidence":{"oneOf":[{"type":"string"},{"type":"null"}]},"coded_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"processed_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"category":{"oneOf":[{"type":"string"},{"type":"null"}]},"subcategory":{"oneOf":[{"type":"string","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`."},{"type":"null","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`."}]},"subcategory_label":{"oneOf":[{"type":"string","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`."},{"type":"null","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`."}]},"event_description":{"oneOf":[{"type":"string","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`."},{"type":"null","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`."}]},"taxonomy_status":{"type":"string","enum":["coded","detail_missing","undeclared_code"]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"event_code":{"oneOf":[{"type":"string"},{"type":"null"}]},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"region":{"oneOf":[{"type":"string"},{"type":"null"}]},"continent":{"oneOf":[{"type":"string"},{"type":"null"}]},"admin1":{"oneOf":[{"type":"string"},{"type":"null"}]},"location":{"oneOf":[{"type":"string"},{"type":"null"}]},"latitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"longitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision_label":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"]},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string"},{"type":"null"}]},"actor_origin_countries":{"type":"array","items":{"type":"string"}}},"required":["location_country","actor_origin_countries"]},"actors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"role":{"type":"string","enum":["source","target","actor1","actor2"],"description":"The part this actor played. CAMEO+ events are directed: `source` acted, `target` was acted upon. Conflict (ACLED) events are undirected and use `actor1`/`actor2`, which imply no initiator. The two pairs never mix on one card — `family` determines which you get."},"primary":{"type":"boolean","description":"True for the coder's PRIMARY actor in this role — the one entity the event is chiefly about on that side, and the one carried in the `source_actor` / `target_actor` columns and filters. False for a co-actor: another entity in the same role in the same action. `actors[]` is ordered primaries-first, and there is at most one `primary: true` per role."},"source_entity_id":{"type":"string","description":"Original actor handle before published canonical identity resolution; actor role is retained."},"entity_id":{"type":"string","description":"In Event responses and facility context previews, an unambiguous identity for this actor, referencing entity_refs. Added through existing identity evidence or a unique exact name/alias lookup; absent for unresolved or conflicting identities."}},"required":["name","country","role","primary"]}},"metrics":{"type":"object","properties":{"significance":{"type":"number"},"severity_tier":{"type":"string","description":"A severity label from reported deaths, civilian targeting and intensity. It is not a band of `significance`, and nothing sorts or filters on it. `critical`: 10 or more deaths, or 3 or more with civilians targeted. `high`: 3 to 9 deaths, or 1 or 2 with civilians targeted. `medium`: 1 or 2 deaths; civilians targeted with no deaths reported; or `magnitude` of 7 or more, or `systemic_importance` of 0.7 or more. `low`: everything else. Deaths and civilian targeting are coded on conflict events only, so a CAMEO+ event is `medium` at most."},"goldstein_scale":{"oneOf":[{"type":"number","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined."},{"type":"null","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined."}]},"magnitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"systemic_importance":{"oneOf":[{"type":"number"},{"type":"null"}]},"propagation_potential":{"oneOf":[{"type":"number"},{"type":"null"}]},"market_sensitivity":{"oneOf":[{"type":"number"},{"type":"null"}]},"confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"article_count":{"oneOf":[{"type":"number","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count."},{"type":"null","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count."}]},"evidence_source_count":{"type":"number","description":"Distinct source URLs attached directly to the Event evidence."},"supporting_story_count":{"type":"number","description":"Number of canonical Story references attached to the Event."},"metric_inputs":{"description":"The EVIDENCE BEHIND THE SCORES — for each metric, the sub-factor values the coder read off the article and the reason it gave for each, keyed by metric. This is what makes a metric auditable rather than something to trust: the published formula turns these inputs into the served value, so you can recompute it yourself. Keyed `magnitude`, `systemic`, `propagation` and `market`; each sub-factor is `{value, why}`, beside descriptive keys such as `node`, and `magnitude` carries its `path`, `value` and `why` directly. Present on most CAMEO+ events; OMITTED where no sub-factor evidence was recorded, which is not the same as none existing — events coded before the field was stored carry nothing, and a backfill has not run. Sub-factor definitions and the formulas: https://docs.gdeltcloud.com/reference/metrics"},"metric_arithmetic":{"type":"object","properties":{"magnitude":{"type":"string"},"systemic_importance":{"type":"string"},"propagation_potential":{"type":"string"},"market_sensitivity":{"type":"string"}},"description":"The ARITHMETIC behind each scaled score: its published formula with this Event's own marks from `metric_inputs` filled in, then its result. Keyed by metric, e.g. `propagation_potential`: \"(channel 0.1 + coupling 0.1 + breach 0 + primed 0.05 + (1 − containment 0.7)) / 5 = 0.11\". `=` is exact. Where the exact value has more than two decimals the line shows it, then `→` the score, which is that value rounded to two decimals in binary floating point as stored, so an exact half can round down: \"(claim_exposure 0.15 + economic_bite 0.2) / 2 = 0.175 → 0.17\". A value that does not end within six decimals is cut to four and marked \"…\". A score a gate set to 0, or left NULL because the article gave no observable, states why instead: \"claim_exposure 0 ≤ 0.05 → nothing traded is exposed → 0\". A line is served only when it reproduces the score served beside it, so a metric's line is OMITTED, never approximated, when its marks are missing or the row predates the published formulas (see `metric_version`). `significance` has no line. Formulas: https://docs.gdeltcloud.com/reference/metrics"},"metric_version":{"type":"string","description":"The scoring version of a CAMEO+ event's metrics. Absent on conflict events, which have no sub-factor metrics, and on CAMEO+ events scored before versions were recorded."},"observation_count":{"oneOf":[{"type":"number","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it."},{"type":"null","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it."}]},"prominence":{"oneOf":[{"type":"number","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count."},{"type":"null","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count."}]}},"required":["significance","severity_tier","goldstein_scale","magnitude","systemic_importance","propagation_potential","market_sensitivity","confidence","article_count","evidence_source_count","supporting_story_count"]},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor."},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor."}]},"spread":{"type":"object","properties":{"story_id":{"oneOf":[{"type":"string","description":"The primary Story whose reach ranks the Event."},{"type":"null","description":"The primary Story whose reach ranks the Event."}]},"outlets":{"type":"number","description":"Distinct outlets that reported that Story."},"first_of_story":{"type":"boolean","description":"True for the Story's most prominent Event, which ranks before the Story's other Events."}},"required":["story_id","outlets","first_of_story"],"description":"Only with sort=spread."},"has_fatalities":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"fatalities":{"oneOf":[{"type":"number"},{"type":"null"}]},"fatalities_basis":{"oneOf":[{"type":"string","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"]},{"type":"null","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"]}]},"fatalities_corroboration":{"oneOf":[{"type":"string","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"]},{"type":"null","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"]}]},"fatalities_evidence":{"oneOf":[{"type":"string"},{"type":"null"}]},"fatalities_supporting_source_count":{"oneOf":[{"type":"number"},{"type":"null"}]},"injured":{"oneOf":[{"type":"number"},{"type":"null"}]},"civilians_killed":{"oneOf":[{"type":"number"},{"type":"null"}]},"civilians_injured":{"oneOf":[{"type":"number"},{"type":"null"}]},"civilian_targeting":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"civilian_targeting_label":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"article_count":{"type":"number"}},"required":["id","url","title","story_date","article_count"]}},"entity_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]}},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain_avatar_url":{"oneOf":[{"type":"string"},{"type":"null"}]},"rank":{"type":"number"}},"required":["url","title","domain","domain_avatar_url","rank"]}},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string"},"count":{"type":"number"}},"required":["language","count"]}},"top_language":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_date":{"type":"string"},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one."},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one."}]},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests."},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered."},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity."},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder."},"role":{"oneOf":[{"type":"string"},{"type":"null"}]},"decision":{"type":"string","enum":["coverage"]},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching."},{"type":"null","description":"Reserved; null for coverage matching."}]},"resolution_confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"resolution_method":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence":{"oneOf":[{},{"type":"null"}]},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id."},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it."}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"]},"incident":{"type":"object","properties":{"uid":{"type":"string","description":"The incident key. Group or `uniqExact` on this instead of `event_uid` to count INCIDENTS rather than coded stories. Equal to `event_uid` unless a judge confirmed this event duplicates another, in which case it is the surviving event of the group. ALWAYS read `resolution` before trusting it: on an `unadjudicated` row this value is a fallback, not a verdict."},"resolution":{"type":"string","enum":["unadjudicated","self","llm"],"description":"How `uid` was decided. `unadjudicated` — this event was never compared to anything, and `uid` defaults to `event_uid`. `self` — compared and found unique. `llm` — an independent adversarial judge confirmed a duplicate and `uid` names the survivor. Coverage is deliberately partial and visible: only events that were candidates for a duplicate are ever adjudicated."},"confidence":{"oneOf":[{"type":"number","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge."},{"type":"null","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge."}]}},"required":["uid","resolution","confidence"]}},"required":["id","url","primary_story_url","family","title","title_source","summary","event_date","observed_at","event_date_basis","event_date_evidence","coded_at","updated_at","processed_at","category","subcategory","subcategory_label","event_description","taxonomy_status","domain","event_code","geo","geo_context","actors","metrics","has_fatalities","fatalities","fatalities_basis","fatalities_corroboration","fatalities_evidence","fatalities_supporting_source_count","injured","civilians_killed","civilians_injured","civilian_targeting","civilian_targeting_label","story_refs","entity_refs","top_articles","language_breakdown","top_language","search_score","incident"]},"description":"Separate best-effort reporting for exact reported-name matches; never promoted to resolved owner_events.","uniqueKey":"reported_owner_events.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_events","typeLabel":"object[] | null"},"reported_owner_stories":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].id","typeLabel":"string"},"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].recorded_at","typeLabel":"string"},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].published_at","typeLabel":"string"},"url":{"oneOf":[{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title","typeLabel":"string | null"},"story_date":{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].story_date","typeLabel":"string"},"updated_at":{"oneOf":[{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].updated_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].updated_at","typeLabel":"string | null"},"processed_at":{"oneOf":[{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].processed_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].processed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].processed_at","typeLabel":"string | null"},"category":{"oneOf":[{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].category.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].category.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].category","typeLabel":"string | null"},"category_code":{"oneOf":[{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].category_code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].category_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].category_code","typeLabel":"string | null"},"subcategory":{"oneOf":[{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].subcategory.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].subcategory.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].subcategory","typeLabel":"string | null"},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.country","typeLabel":"string | null"},"region":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.region.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.region.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.region","typeLabel":"string | null"},"continent":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.continent.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.continent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.continent","typeLabel":"string | null"},"admin1":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.admin1.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.admin1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.admin1","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.location.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.location","typeLabel":"string | null"},"latitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.latitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.latitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.longitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.longitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.longitude","typeLabel":"number | null"},"geo_precision":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.geo_precision","typeLabel":"number | null"},"geo_precision_label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo.geo_precision_label","typeLabel":"string | null"}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo","typeLabel":"object"},"geo_provenance":{"oneOf":[{"type":"object","properties":{"method":{"type":"string","enum":["representative_linked_event"],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.0.method","typeLabel":"enum\u003cstring>"},"event_id":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.0.event_id","typeLabel":"string"}},"required":["method","event_id"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"method":{"type":"string","enum":["representative_linked_event"]},"event_id":{"type":"string"}},"required":["method","event_id"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_provenance","typeLabel":"object | null"},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_context.location_country","typeLabel":"string | null"},"actor_origin_countries":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.oneOf.0.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries","typeLabel":"string[] | null"}},"required":["location_country","actor_origin_countries"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].geo_context","typeLabel":"object"},"metrics":{"type":"object","properties":{"significance":{"type":"number","description":"How widely the Story was reported: its article count on a log scale, min(1, ln(1 + article_count) / ln(10001)), rounded to four decimals. 1 article scores 0.0753, 100 articles 0.5011, 1,000 articles 0.7501, and 10,000 or more 1. Its Events' importance is `max_linked_event_significance`.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.significance","typeLabel":"number"},"article_count":{"type":"number","description":"Articles the Story holds. One page is counted more than once when it arrived under URLs that differ only in http or https, a leading `www.`, trailing slashes or tracking parameters such as `utm_*`; GET /api/v2/stories/{story_id}/articles lists each page once, so it can return fewer articles.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.article_count","typeLabel":"number"},"linked_event_count":{"oneOf":[{"type":"number","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.linked_event_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.linked_event_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.linked_event_count","typeLabel":"number | null"},"max_linked_event_significance":{"oneOf":[{"type":"number","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.max_linked_event_significance.oneOf.0","typeLabel":"number"},{"type":"null","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.max_linked_event_significance.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.max_linked_event_significance","typeLabel":"number | null"},"civilian_targeting_event_count":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.civilian_targeting_event_count.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.civilian_targeting_event_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.civilian_targeting_event_count","typeLabel":"number | null"},"outlet_count":{"oneOf":[{"type":"number","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.outlet_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.outlet_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics.outlet_count","typeLabel":"number | null"}},"required":["significance","article_count","linked_event_count","max_linked_event_significance","civilian_targeting_event_count"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].metrics","typeLabel":"object"},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.recent_count","typeLabel":"number"},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count","typeLabel":"number | null"},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count","typeLabel":"number | null"},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.0","typeLabel":"number"},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.change","typeLabel":"number | null"},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.score","typeLabel":"number"},"recent_start":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.recent_start","typeLabel":"string"},"recent_end":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.recent_end","typeLabel":"string"},"baseline_start":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_start","typeLabel":"string"},"baseline_end":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_end","typeLabel":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].rising","typeLabel":"object | null"},"event_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means linked-Event evidence could not be read; event-derived counts, flags and arrays are null, not measured zero or empty.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].event_enrichment_status","typeLabel":"enum\u003cstring>"},"entity_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means Story entity evidence was not published; entity_refs is null rather than misleadingly empty.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_enrichment_status","typeLabel":"enum\u003cstring>"},"has_events":{"oneOf":[{"type":"boolean","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].has_events.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].has_events.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].has_events","typeLabel":"boolean | null"},"has_fatalities":{"oneOf":[{"type":"boolean","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].has_fatalities.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].has_fatalities.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].has_fatalities","typeLabel":"boolean | null"},"has_civilian_targeting":{"oneOf":[{"type":"boolean","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].has_civilian_targeting.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].has_civilian_targeting.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].has_civilian_targeting","typeLabel":"boolean | null"},"fatalities":{"oneOf":[{"type":"number","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`).","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].fatalities.oneOf.0","typeLabel":"number"},{"type":"null","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`).","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].fatalities.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].fatalities","typeLabel":"number | null"},"linked_events":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].id","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].title","typeLabel":"string | null"}},"required":["id","title"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title"]},"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].linked_events.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].linked_events","typeLabel":"object[] | null"},"entity_refs":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].name","typeLabel":"string"},"source_entity_ids":{"type":"array","items":{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].source_entity_ids.items.[INDEX]","typeLabel":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].source_entity_ids","typeLabel":"string[]"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.checked","typeLabel":"boolean"},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.is_public_official.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.is_public_official.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.is_public_official","typeLabel":"boolean | null"},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.status","typeLabel":"enum\u003cstring> | null"},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.total.oneOf.0","typeLabel":"number"},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.total","typeLabel":"number | null"},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].office_id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].name","typeLabel":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.0","typeLabel":"string"},{"type":"null","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].country_iso3","typeLabel":"string | null"},"status":{"type":"string","enum":["current","ended","unknown"],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"start_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].start_date","typeLabel":"string | null"},"end_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].end_date","typeLabel":"string | null"},"evidence_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].evidence_date","typeLabel":"string | null"},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].source_key","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url","typeLabel":"string | null"}},"required":["source_key","url"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources","typeLabel":"object[]"}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices","typeLabel":"object[]"},"truncated":{"type":"boolean","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.truncated","typeLabel":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official","typeLabel":"object"}},"required":["id","name"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]},"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_refs","typeLabel":"object[] | null"},"matched_categories":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0.items.[INDEX].code","typeLabel":"string"},"label":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0.items.[INDEX].label","typeLabel":"string"}},"required":["code","label"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]},"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].matched_categories","typeLabel":"object[] | null"},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].url","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain","typeLabel":"string | null"},"rank":{"type":"number","description":"Position in the Story's article ranking, 1 being the Story's anchor. GET /api/v2/stories/{story_id}/articles lists every article in the same ranking.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].rank","typeLabel":"number"}},"required":["url","title","domain","rank"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX]","typeLabel":"object"},"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_articles","typeLabel":"object[]"},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].language","typeLabel":"string"},"count":{"type":"number","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].count","typeLabel":"number"}},"required":["language","count"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX]","typeLabel":"object"},"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].language_breakdown","typeLabel":"object[]"},"top_language":{"oneOf":[{"type":"string","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_language.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_language.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].top_language","typeLabel":"string | null"},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.entity","typeLabel":"string"},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.mode","typeLabel":"enum\u003cstring>"},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.via","typeLabel":"enum\u003cstring>"},"role":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.role.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.role.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.role","typeLabel":"string | null"},"decision":{"type":"string","enum":["coverage"],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.decision","typeLabel":"enum\u003cstring>"},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.materiality_confidence","typeLabel":"number | null"},"resolution_confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_confidence","typeLabel":"number | null"},"resolution_method":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.resolution_method","typeLabel":"string | null"},"evidence":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.evidence","typeLabel":"null"},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.story_date","typeLabel":"string"},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link.story_id","typeLabel":"string"}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].entity_link","typeLabel":"object"},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].search_score.oneOf.0","typeLabel":"number"},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].search_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].search_score","typeLabel":"number | null"},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].match_type","typeLabel":"enum\u003cstring>"},"title_history":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].title","typeLabel":"string"},"previous_title":{"type":"string","description":"The title it replaced.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].previous_title","typeLabel":"string"},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC).","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].changed_at","typeLabel":"string"},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"article_count":{"type":"number","description":"Articles the Story held when the title changed.","isRequired":true,"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].article_count","typeLabel":"number"}},"required":["title","previous_title","changed_at","reason","article_count"],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`."},"previous_title":{"type":"string","description":"The title it replaced."},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC)."},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story."},"article_count":{"type":"number","description":"Articles the Story held when the title changed."}},"required":["title","previous_title","changed_at","reason","article_count"]},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title_history.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].title_history","typeLabel":"object[] | null"},"event_count":{"type":"number","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX].event_count","typeLabel":"number"}},"required":["id"],"description":"Story referenced by the returned Events, hydrated through the canonical Stories serving API with category, metrics and identity evidence when available. Not an exhaustive facility Story search.","uniqueKey":"reported_owner_stories.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"reported_owner_stories.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries."},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries."},"id":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_date":{"type":"string"},"updated_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"processed_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"category":{"oneOf":[{"type":"string"},{"type":"null"}]},"category_code":{"oneOf":[{"type":"string"},{"type":"null"}]},"subcategory":{"oneOf":[{"type":"string"},{"type":"null"}]},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"region":{"oneOf":[{"type":"string"},{"type":"null"}]},"continent":{"oneOf":[{"type":"string"},{"type":"null"}]},"admin1":{"oneOf":[{"type":"string"},{"type":"null"}]},"location":{"oneOf":[{"type":"string"},{"type":"null"}]},"latitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"longitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision_label":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"]},"geo_provenance":{"oneOf":[{"type":"object","properties":{"method":{"type":"string","enum":["representative_linked_event"]},"event_id":{"type":"string"}},"required":["method","event_id"]},{"type":"null","properties":{"method":{"type":"string","enum":["representative_linked_event"]},"event_id":{"type":"string"}},"required":["method","event_id"]}]},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string"},{"type":"null"}]},"actor_origin_countries":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}},"required":["location_country","actor_origin_countries"]},"metrics":{"type":"object","properties":{"significance":{"type":"number","description":"How widely the Story was reported: its article count on a log scale, min(1, ln(1 + article_count) / ln(10001)), rounded to four decimals. 1 article scores 0.0753, 100 articles 0.5011, 1,000 articles 0.7501, and 10,000 or more 1. Its Events' importance is `max_linked_event_significance`."},"article_count":{"type":"number","description":"Articles the Story holds. One page is counted more than once when it arrived under URLs that differ only in http or https, a leading `www.`, trailing slashes or tracking parameters such as `utm_*`; GET /api/v2/stories/{story_id}/articles lists each page once, so it can return fewer articles."},"linked_event_count":{"oneOf":[{"type":"number","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable."},{"type":"null","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable."}]},"max_linked_event_significance":{"oneOf":[{"type":"number","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable."},{"type":"null","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable."}]},"civilian_targeting_event_count":{"oneOf":[{"type":"number"},{"type":"null"}]},"outlet_count":{"oneOf":[{"type":"number","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it."},{"type":"null","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it."}]}},"required":["significance","article_count","linked_event_count","max_linked_event_significance","civilian_targeting_event_count"]},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor."},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor."}]},"event_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means linked-Event evidence could not be read; event-derived counts, flags and arrays are null, not measured zero or empty."},"entity_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means Story entity evidence was not published; entity_refs is null rather than misleadingly empty."},"has_events":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"has_fatalities":{"oneOf":[{"type":"boolean","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable."},{"type":"null","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable."}]},"has_civilian_targeting":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"fatalities":{"oneOf":[{"type":"number","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`)."},{"type":"null","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`)."}]},"linked_events":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title"]}},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title"]}}]},"entity_refs":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]}},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]}}]},"matched_categories":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]}},{"type":"null","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]}}]},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"rank":{"type":"number","description":"Position in the Story's article ranking, 1 being the Story's anchor. GET /api/v2/stories/{story_id}/articles lists every article in the same ranking."}},"required":["url","title","domain","rank"]}},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string"},"count":{"type":"number"}},"required":["language","count"]}},"top_language":{"oneOf":[{"type":"string"},{"type":"null"}]},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered."},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity."},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder."},"role":{"oneOf":[{"type":"string"},{"type":"null"}]},"decision":{"type":"string","enum":["coverage"]},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching."},{"type":"null","description":"Reserved; null for coverage matching."}]},"resolution_confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"resolution_method":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence":{"oneOf":[{},{"type":"null"}]},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id."},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it."}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"]},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match."},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match."}]},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests."},"title_history":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`."},"previous_title":{"type":"string","description":"The title it replaced."},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC)."},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story."},"article_count":{"type":"number","description":"Articles the Story held when the title changed."}},"required":["title","previous_title","changed_at","reason","article_count"]},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses."},{"type":"null","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`."},"previous_title":{"type":"string","description":"The title it replaced."},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC)."},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story."},"article_count":{"type":"number","description":"Articles the Story held when the title changed."}},"required":["title","previous_title","changed_at","reason","article_count"]},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses."}]},"event_count":{"type":"number"}},"required":["id"],"description":"Story referenced by the returned Events, hydrated through the canonical Stories serving API with category, metrics and identity evidence when available. Not an exhaustive facility Story search."},"uniqueKey":"reported_owner_stories.oneOf.1","typeLabel":"null"}],"uniqueKey":"reported_owner_stories","typeLabel":"object[] | null"},"nearby_events":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].id","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"primary_story_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].primary_story_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].primary_story_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].primary_story_url","typeLabel":"string | null"},"family":{"type":"string","enum":["conflict","cameoplus"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].family","typeLabel":"enum\u003cstring>"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].title","typeLabel":"string | null"},"title_source":{"type":"string","enum":["coder_title","cluster_label","event_description","actor_pair","actor","sub_event_type","event_type_in_location","event_type","domain_in_location","domain","fallback"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].title_source","typeLabel":"enum\u003cstring>"},"summary":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].summary.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].summary.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].summary","typeLabel":"string | null"},"event_date":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_date","typeLabel":"string"},"observed_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].observed_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].observed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].observed_at","typeLabel":"string | null"},"event_date_basis":{"oneOf":[{"type":"string","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_date_basis.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_date_basis.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_date_basis","typeLabel":"enum\u003cstring> | null"},"event_date_evidence":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_date_evidence.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_date_evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_date_evidence","typeLabel":"string | null"},"coded_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].coded_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].coded_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].coded_at","typeLabel":"string | null"},"updated_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].updated_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].updated_at","typeLabel":"string | null"},"processed_at":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].processed_at.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].processed_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].processed_at","typeLabel":"string | null"},"category":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].category.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].category.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].category","typeLabel":"string | null"},"subcategory":{"oneOf":[{"type":"string","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].subcategory.oneOf.0","typeLabel":"string"},{"type":"null","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].subcategory.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].subcategory","typeLabel":"string | null"},"subcategory_label":{"oneOf":[{"type":"string","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].subcategory_label.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].subcategory_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].subcategory_label","typeLabel":"string | null"},"event_description":{"oneOf":[{"type":"string","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_description.oneOf.0","typeLabel":"string"},{"type":"null","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_description","typeLabel":"string | null"},"taxonomy_status":{"type":"string","enum":["coded","detail_missing","undeclared_code"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].taxonomy_status","typeLabel":"enum\u003cstring>"},"domain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].domain","typeLabel":"string | null"},"event_code":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_code.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_code.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].event_code","typeLabel":"string | null"},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.country","typeLabel":"string | null"},"region":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.region.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.region.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.region","typeLabel":"string | null"},"continent":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.continent.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.continent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.continent","typeLabel":"string | null"},"admin1":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.admin1.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.admin1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.admin1","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.location.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.location","typeLabel":"string | null"},"latitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.latitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.latitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.longitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.longitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.longitude","typeLabel":"number | null"},"geo_precision":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.geo_precision","typeLabel":"number | null"},"geo_precision_label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo.geo_precision_label","typeLabel":"string | null"}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo","typeLabel":"object"},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo_context.location_country","typeLabel":"string | null"},"actor_origin_countries":{"type":"array","items":{"type":"string","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo_context.actor_origin_countries","typeLabel":"string[]"}},"required":["location_country","actor_origin_countries"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].geo_context","typeLabel":"object"},"actors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors.items.[INDEX].name","typeLabel":"string"},"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors.items.[INDEX].country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors.items.[INDEX].country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors.items.[INDEX].country","typeLabel":"string | null"},"role":{"type":"string","enum":["source","target","actor1","actor2"],"description":"The part this actor played. CAMEO+ events are directed: `source` acted, `target` was acted upon. Conflict (ACLED) events are undirected and use `actor1`/`actor2`, which imply no initiator. The two pairs never mix on one card — `family` determines which you get.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"primary":{"type":"boolean","description":"True for the coder's PRIMARY actor in this role — the one entity the event is chiefly about on that side, and the one carried in the `source_actor` / `target_actor` columns and filters. False for a co-actor: another entity in the same role in the same action. `actors[]` is ordered primaries-first, and there is at most one `primary: true` per role.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors.items.[INDEX].primary","typeLabel":"boolean"},"source_entity_id":{"type":"string","description":"Original actor handle before published canonical identity resolution; actor role is retained.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors.items.[INDEX].source_entity_id","typeLabel":"string"},"entity_id":{"type":"string","description":"In Event responses and facility context previews, an unambiguous identity for this actor, referencing entity_refs. Added through existing identity evidence or a unique exact name/alias lookup; absent for unresolved or conflicting identities.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors.items.[INDEX].entity_id","typeLabel":"string"}},"required":["name","country","role","primary"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].actors","typeLabel":"object[]"},"metrics":{"type":"object","properties":{"significance":{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.significance","typeLabel":"number"},"severity_tier":{"type":"string","description":"A severity label from reported deaths, civilian targeting and intensity. It is not a band of `significance`, and nothing sorts or filters on it. `critical`: 10 or more deaths, or 3 or more with civilians targeted. `high`: 3 to 9 deaths, or 1 or 2 with civilians targeted. `medium`: 1 or 2 deaths; civilians targeted with no deaths reported; or `magnitude` of 7 or more, or `systemic_importance` of 0.7 or more. `low`: everything else. Deaths and civilian targeting are coded on conflict events only, so a CAMEO+ event is `medium` at most.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.severity_tier","typeLabel":"string"},"goldstein_scale":{"oneOf":[{"type":"number","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.goldstein_scale.oneOf.0","typeLabel":"number"},{"type":"null","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.goldstein_scale.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.goldstein_scale","typeLabel":"number | null"},"magnitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.magnitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.magnitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.magnitude","typeLabel":"number | null"},"systemic_importance":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.systemic_importance.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.systemic_importance.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.systemic_importance","typeLabel":"number | null"},"propagation_potential":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.propagation_potential.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.propagation_potential.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.propagation_potential","typeLabel":"number | null"},"market_sensitivity":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.market_sensitivity.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.market_sensitivity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.market_sensitivity","typeLabel":"number | null"},"confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.confidence","typeLabel":"number | null"},"article_count":{"oneOf":[{"type":"number","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.article_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.article_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.article_count","typeLabel":"number | null"},"evidence_source_count":{"type":"number","description":"Distinct source URLs attached directly to the Event evidence.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.evidence_source_count","typeLabel":"number"},"supporting_story_count":{"type":"number","description":"Number of canonical Story references attached to the Event.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.supporting_story_count","typeLabel":"number"},"metric_inputs":{"description":"The EVIDENCE BEHIND THE SCORES — for each metric, the sub-factor values the coder read off the article and the reason it gave for each, keyed by metric. This is what makes a metric auditable rather than something to trust: the published formula turns these inputs into the served value, so you can recompute it yourself. Keyed `magnitude`, `systemic`, `propagation` and `market`; each sub-factor is `{value, why}`, beside descriptive keys such as `node`, and `magnitude` carries its `path`, `value` and `why` directly. Present on most CAMEO+ events; OMITTED where no sub-factor evidence was recorded, which is not the same as none existing — events coded before the field was stored carry nothing, and a backfill has not run. Sub-factor definitions and the formulas: https://docs.gdeltcloud.com/reference/metrics","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.metric_inputs","typeLabel":"any"},"metric_arithmetic":{"type":"object","properties":{"magnitude":{"type":"string","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.magnitude","typeLabel":"string"},"systemic_importance":{"type":"string","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.systemic_importance","typeLabel":"string"},"propagation_potential":{"type":"string","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.propagation_potential","typeLabel":"string"},"market_sensitivity":{"type":"string","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic.market_sensitivity","typeLabel":"string"}},"description":"The ARITHMETIC behind each scaled score: its published formula with this Event's own marks from `metric_inputs` filled in, then its result. Keyed by metric, e.g. `propagation_potential`: \"(channel 0.1 + coupling 0.1 + breach 0 + primed 0.05 + (1 − containment 0.7)) / 5 = 0.11\". `=` is exact. Where the exact value has more than two decimals the line shows it, then `→` the score, which is that value rounded to two decimals in binary floating point as stored, so an exact half can round down: \"(claim_exposure 0.15 + economic_bite 0.2) / 2 = 0.175 → 0.17\". A value that does not end within six decimals is cut to four and marked \"…\". A score a gate set to 0, or left NULL because the article gave no observable, states why instead: \"claim_exposure 0 ≤ 0.05 → nothing traded is exposed → 0\". A line is served only when it reproduces the score served beside it, so a metric's line is OMITTED, never approximated, when its marks are missing or the row predates the published formulas (see `metric_version`). `significance` has no line. Formulas: https://docs.gdeltcloud.com/reference/metrics","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.metric_arithmetic","typeLabel":"object"},"metric_version":{"type":"string","description":"The scoring version of a CAMEO+ event's metrics. Absent on conflict events, which have no sub-factor metrics, and on CAMEO+ events scored before versions were recorded.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.metric_version","typeLabel":"string"},"observation_count":{"oneOf":[{"type":"number","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.observation_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.observation_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.observation_count","typeLabel":"number | null"},"prominence":{"oneOf":[{"type":"number","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.prominence.oneOf.0","typeLabel":"number"},{"type":"null","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.prominence.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics.prominence","typeLabel":"number | null"}},"required":["significance","severity_tier","goldstein_scale","magnitude","systemic_importance","propagation_potential","market_sensitivity","confidence","article_count","evidence_source_count","supporting_story_count"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].metrics","typeLabel":"object"},"has_fatalities":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].has_fatalities.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].has_fatalities.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].has_fatalities","typeLabel":"boolean | null"},"fatalities":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities","typeLabel":"number | null"},"fatalities_basis":{"oneOf":[{"type":"string","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_basis.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_basis.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_basis","typeLabel":"enum\u003cstring> | null"},"fatalities_corroboration":{"oneOf":[{"type":"string","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_corroboration.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_corroboration.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_corroboration","typeLabel":"enum\u003cstring> | null"},"fatalities_evidence":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_evidence.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_evidence","typeLabel":"string | null"},"fatalities_supporting_source_count":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_supporting_source_count.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_supporting_source_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].fatalities_supporting_source_count","typeLabel":"number | null"},"injured":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].injured.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].injured.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].injured","typeLabel":"number | null"},"civilians_killed":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilians_killed.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilians_killed.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilians_killed","typeLabel":"number | null"},"civilians_injured":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilians_injured.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilians_injured.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilians_injured","typeLabel":"number | null"},"civilian_targeting":{"oneOf":[{"type":"boolean","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilian_targeting.oneOf.0","typeLabel":"boolean"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilian_targeting.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilian_targeting","typeLabel":"boolean | null"},"civilian_targeting_label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilian_targeting_label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilian_targeting_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].civilian_targeting_label","typeLabel":"string | null"},"story_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].id","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].url","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].title","typeLabel":"string | null"},"story_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].story_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].story_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].story_date","typeLabel":"string | null"},"article_count":{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX].article_count","typeLabel":"number"}},"required":["id","url","title","story_date","article_count"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_refs","typeLabel":"object[]"},"entity_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].name","typeLabel":"string"},"source_entity_ids":{"type":"array","items":{"type":"string","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].source_entity_ids.items.[INDEX]","typeLabel":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].source_entity_ids","typeLabel":"string[]"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.checked","typeLabel":"boolean"},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.is_public_official.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.is_public_official.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.is_public_official","typeLabel":"boolean | null"},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.status","typeLabel":"enum\u003cstring> | null"},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.total.oneOf.0","typeLabel":"number"},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.total","typeLabel":"number | null"},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].office_id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].name","typeLabel":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.0","typeLabel":"string"},{"type":"null","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].country_iso3","typeLabel":"string | null"},"status":{"type":"string","enum":["current","ended","unknown"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"start_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].start_date","typeLabel":"string | null"},"end_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].end_date","typeLabel":"string | null"},"evidence_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].evidence_date","typeLabel":"string | null"},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].source_key","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url","typeLabel":"string | null"}},"required":["source_key","url"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX].sources","typeLabel":"object[]"}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.offices","typeLabel":"object[]"},"truncated":{"type":"boolean","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official.truncated","typeLabel":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX].public_official","typeLabel":"object"}},"required":["id","name"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_refs","typeLabel":"object[]"},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].url","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain","typeLabel":"string | null"},"domain_avatar_url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain_avatar_url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain_avatar_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain_avatar_url","typeLabel":"string | null"},"rank":{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX].rank","typeLabel":"number"}},"required":["url","title","domain","domain_avatar_url","rank"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_articles","typeLabel":"object[]"},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].language","typeLabel":"string"},"count":{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].count","typeLabel":"number"}},"required":["language","count"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].language_breakdown","typeLabel":"object[]"},"top_language":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_language.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_language.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].top_language","typeLabel":"string | null"},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].search_score.oneOf.0","typeLabel":"number"},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].search_score.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].search_score","typeLabel":"number | null"},"incident":{"type":"object","properties":{"uid":{"type":"string","description":"The incident key. Group or `uniqExact` on this instead of `event_uid` to count INCIDENTS rather than coded stories. Equal to `event_uid` unless a judge confirmed this event duplicates another, in which case it is the surviving event of the group. ALWAYS read `resolution` before trusting it: on an `unadjudicated` row this value is a fallback, not a verdict.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].incident.uid","typeLabel":"string"},"resolution":{"type":"string","enum":["unadjudicated","self","llm"],"description":"How `uid` was decided. `unadjudicated` — this event was never compared to anything, and `uid` defaults to `event_uid`. `self` — compared and found unique. `llm` — an independent adversarial judge confirmed a duplicate and `uid` names the survivor. Coverage is deliberately partial and visible: only events that were candidates for a duplicate are ever adjudicated.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].incident.resolution","typeLabel":"enum\u003cstring>"},"confidence":{"oneOf":[{"type":"number","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].incident.confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].incident.confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].incident.confidence","typeLabel":"number | null"}},"required":["uid","resolution","confidence"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].incident","typeLabel":"object"},"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].recorded_at","typeLabel":"string"},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].published_at","typeLabel":"string"},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.recent_count","typeLabel":"number"},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count","typeLabel":"number | null"},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count","typeLabel":"number | null"},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.0","typeLabel":"number"},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.change","typeLabel":"number | null"},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.score","typeLabel":"number"},"recent_start":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.recent_start","typeLabel":"string"},"recent_end":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.recent_end","typeLabel":"string"},"baseline_start":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_start","typeLabel":"string"},"baseline_end":{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_end","typeLabel":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].rising","typeLabel":"object | null"},"spread":{"type":"object","properties":{"story_id":{"oneOf":[{"type":"string","description":"The primary Story whose reach ranks the Event.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].spread.story_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The primary Story whose reach ranks the Event.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].spread.story_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].spread.story_id","typeLabel":"string | null"},"outlets":{"type":"number","description":"Distinct outlets that reported that Story.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].spread.outlets","typeLabel":"number"},"first_of_story":{"type":"boolean","description":"True for the Story's most prominent Event, which ranks before the Story's other Events.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].spread.first_of_story","typeLabel":"boolean"}},"required":["story_id","outlets","first_of_story"],"description":"Only with sort=spread.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].spread","typeLabel":"object"},"story_date":{"type":"string","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].story_date","typeLabel":"string"},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].match_type","typeLabel":"enum\u003cstring>"},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.entity","typeLabel":"string"},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.mode","typeLabel":"enum\u003cstring>"},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.via","typeLabel":"enum\u003cstring>"},"role":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.role.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.role.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.role","typeLabel":"string | null"},"decision":{"type":"string","enum":["coverage"],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.decision","typeLabel":"enum\u003cstring>"},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.materiality_confidence","typeLabel":"number | null"},"resolution_confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.resolution_confidence","typeLabel":"number | null"},"resolution_method":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.resolution_method","typeLabel":"string | null"},"evidence":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.evidence","typeLabel":"null"},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it.","isRequired":true,"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.story_date","typeLabel":"string"},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id.","uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link.story_id","typeLabel":"string"}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX].entity_link","typeLabel":"object"}},"required":["id","url","primary_story_url","family","title","title_source","summary","event_date","observed_at","event_date_basis","event_date_evidence","coded_at","updated_at","processed_at","category","subcategory","subcategory_label","event_description","taxonomy_status","domain","event_code","geo","geo_context","actors","metrics","has_fatalities","fatalities","fatalities_basis","fatalities_corroboration","fatalities_evidence","fatalities_supporting_source_count","injured","civilians_killed","civilians_injured","civilian_targeting","civilian_targeting_label","story_refs","entity_refs","top_articles","language_breakdown","top_language","search_score","incident"],"uniqueKey":"nearby_events.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Optional geographic leads within radius_km; never proof of an incident at the site.","uniqueKey":"nearby_events.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries."},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries."},"id":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]},"primary_story_url":{"oneOf":[{"type":"string"},{"type":"null"}]},"family":{"type":"string","enum":["conflict","cameoplus"]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"title_source":{"type":"string","enum":["coder_title","cluster_label","event_description","actor_pair","actor","sub_event_type","event_type_in_location","event_type","domain_in_location","domain","fallback"]},"summary":{"oneOf":[{"type":"string"},{"type":"null"}]},"event_date":{"type":"string"},"observed_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"event_date_basis":{"oneOf":[{"type":"string","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"]},{"type":"null","enum":["explicit_date","relative_date","publication_day_inference","ongoing_event_update"]}]},"event_date_evidence":{"oneOf":[{"type":"string"},{"type":"null"}]},"coded_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"processed_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"category":{"oneOf":[{"type":"string"},{"type":"null"}]},"subcategory":{"oneOf":[{"type":"string","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`."},{"type":"null","description":"Taxonomy subcategory IDENTIFIER — a CAMEO+ code (e.g. \"EC04\", \"042\") or, for the conflict family, the ACLED sub-event type (e.g. \"Peaceful protest\"). This is exactly what the `subcategory` filter accepts. For the human-readable name, read `subcategory_label`."}]},"subcategory_label":{"oneOf":[{"type":"string","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`."},{"type":"null","description":"Human-readable name for `subcategory` (e.g. \"Trade Policy Action\"). NULL when the code is not one the taxonomy declares — see `taxonomy_status`. Not a filter value; filter on `subcategory`."}]},"event_description":{"oneOf":[{"type":"string","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`."},{"type":"null","description":"The coder's free-text description of this specific event (e.g. \"Landslide\"), usually more specific than `subcategory_label`, which names the CODE. CAMEO+ only; NULL for the conflict family. Free text — not stable, not a filter value, and not safe to group by: group on `subcategory`."}]},"taxonomy_status":{"type":"string","enum":["coded","detail_missing","undeclared_code"]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"event_code":{"oneOf":[{"type":"string"},{"type":"null"}]},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"region":{"oneOf":[{"type":"string"},{"type":"null"}]},"continent":{"oneOf":[{"type":"string"},{"type":"null"}]},"admin1":{"oneOf":[{"type":"string"},{"type":"null"}]},"location":{"oneOf":[{"type":"string"},{"type":"null"}]},"latitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"longitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision_label":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"]},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string"},{"type":"null"}]},"actor_origin_countries":{"type":"array","items":{"type":"string"}}},"required":["location_country","actor_origin_countries"]},"actors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"role":{"type":"string","enum":["source","target","actor1","actor2"],"description":"The part this actor played. CAMEO+ events are directed: `source` acted, `target` was acted upon. Conflict (ACLED) events are undirected and use `actor1`/`actor2`, which imply no initiator. The two pairs never mix on one card — `family` determines which you get."},"primary":{"type":"boolean","description":"True for the coder's PRIMARY actor in this role — the one entity the event is chiefly about on that side, and the one carried in the `source_actor` / `target_actor` columns and filters. False for a co-actor: another entity in the same role in the same action. `actors[]` is ordered primaries-first, and there is at most one `primary: true` per role."},"source_entity_id":{"type":"string","description":"Original actor handle before published canonical identity resolution; actor role is retained."},"entity_id":{"type":"string","description":"In Event responses and facility context previews, an unambiguous identity for this actor, referencing entity_refs. Added through existing identity evidence or a unique exact name/alias lookup; absent for unresolved or conflicting identities."}},"required":["name","country","role","primary"]}},"metrics":{"type":"object","properties":{"significance":{"type":"number"},"severity_tier":{"type":"string","description":"A severity label from reported deaths, civilian targeting and intensity. It is not a band of `significance`, and nothing sorts or filters on it. `critical`: 10 or more deaths, or 3 or more with civilians targeted. `high`: 3 to 9 deaths, or 1 or 2 with civilians targeted. `medium`: 1 or 2 deaths; civilians targeted with no deaths reported; or `magnitude` of 7 or more, or `systemic_importance` of 0.7 or more. `low`: everything else. Deaths and civilian targeting are coded on conflict events only, so a CAMEO+ event is `medium` at most."},"goldstein_scale":{"oneOf":[{"type":"number","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined."},{"type":"null","description":"Goldstein conflict-cooperation scale, -10 to +10. NULL is deterministic, not sparse coverage: it is set on every conflict (ACLED) event and every CAMEO+ POLITICAL event, and NULL in every other CAMEO+ domain, where the scale is not defined."}]},"magnitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"systemic_importance":{"oneOf":[{"type":"number"},{"type":"null"}]},"propagation_potential":{"oneOf":[{"type":"number"},{"type":"null"}]},"market_sensitivity":{"oneOf":[{"type":"number"},{"type":"null"}]},"confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"article_count":{"oneOf":[{"type":"number","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count."},{"type":"null","description":"Canonical Story article count. NULL when the Event has no canonical Story measurement; never fabricated from source URL count."}]},"evidence_source_count":{"type":"number","description":"Distinct source URLs attached directly to the Event evidence."},"supporting_story_count":{"type":"number","description":"Number of canonical Story references attached to the Event."},"metric_inputs":{"description":"The EVIDENCE BEHIND THE SCORES — for each metric, the sub-factor values the coder read off the article and the reason it gave for each, keyed by metric. This is what makes a metric auditable rather than something to trust: the published formula turns these inputs into the served value, so you can recompute it yourself. Keyed `magnitude`, `systemic`, `propagation` and `market`; each sub-factor is `{value, why}`, beside descriptive keys such as `node`, and `magnitude` carries its `path`, `value` and `why` directly. Present on most CAMEO+ events; OMITTED where no sub-factor evidence was recorded, which is not the same as none existing — events coded before the field was stored carry nothing, and a backfill has not run. Sub-factor definitions and the formulas: https://docs.gdeltcloud.com/reference/metrics"},"metric_arithmetic":{"type":"object","properties":{"magnitude":{"type":"string"},"systemic_importance":{"type":"string"},"propagation_potential":{"type":"string"},"market_sensitivity":{"type":"string"}},"description":"The ARITHMETIC behind each scaled score: its published formula with this Event's own marks from `metric_inputs` filled in, then its result. Keyed by metric, e.g. `propagation_potential`: \"(channel 0.1 + coupling 0.1 + breach 0 + primed 0.05 + (1 − containment 0.7)) / 5 = 0.11\". `=` is exact. Where the exact value has more than two decimals the line shows it, then `→` the score, which is that value rounded to two decimals in binary floating point as stored, so an exact half can round down: \"(claim_exposure 0.15 + economic_bite 0.2) / 2 = 0.175 → 0.17\". A value that does not end within six decimals is cut to four and marked \"…\". A score a gate set to 0, or left NULL because the article gave no observable, states why instead: \"claim_exposure 0 ≤ 0.05 → nothing traded is exposed → 0\". A line is served only when it reproduces the score served beside it, so a metric's line is OMITTED, never approximated, when its marks are missing or the row predates the published formulas (see `metric_version`). `significance` has no line. Formulas: https://docs.gdeltcloud.com/reference/metrics"},"metric_version":{"type":"string","description":"The scoring version of a CAMEO+ event's metrics. Absent on conflict events, which have no sub-factor metrics, and on CAMEO+ events scored before versions were recorded."},"observation_count":{"oneOf":[{"type":"number","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it."},{"type":"null","description":"Independently clustered reports judged to be this same incident. Null where the row source does not carry it."}]},"prominence":{"oneOf":[{"type":"number","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count."},{"type":"null","description":"The sort=prominence score: 0.7 × significance + 0.3 × min(1, ln(observation_count) / ln(50)). Null without observation_count."}]}},"required":["significance","severity_tier","goldstein_scale","magnitude","systemic_importance","propagation_potential","market_sensitivity","confidence","article_count","evidence_source_count","supporting_story_count"]},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor."},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the articles of the Event's Stories in the window against the seven days before; null below the recent floor."}]},"spread":{"type":"object","properties":{"story_id":{"oneOf":[{"type":"string","description":"The primary Story whose reach ranks the Event."},{"type":"null","description":"The primary Story whose reach ranks the Event."}]},"outlets":{"type":"number","description":"Distinct outlets that reported that Story."},"first_of_story":{"type":"boolean","description":"True for the Story's most prominent Event, which ranks before the Story's other Events."}},"required":["story_id","outlets","first_of_story"],"description":"Only with sort=spread."},"has_fatalities":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"fatalities":{"oneOf":[{"type":"number"},{"type":"null"}]},"fatalities_basis":{"oneOf":[{"type":"string","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"]},{"type":"null","enum":["reported_exact","reported_minimum","reported_range","estimated","none_reported"]}]},"fatalities_corroboration":{"oneOf":[{"type":"string","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"]},{"type":"null","enum":["multi_source_independent","single_source","party_to_conflict_claim","contested","none_reported"]}]},"fatalities_evidence":{"oneOf":[{"type":"string"},{"type":"null"}]},"fatalities_supporting_source_count":{"oneOf":[{"type":"number"},{"type":"null"}]},"injured":{"oneOf":[{"type":"number"},{"type":"null"}]},"civilians_killed":{"oneOf":[{"type":"number"},{"type":"null"}]},"civilians_injured":{"oneOf":[{"type":"number"},{"type":"null"}]},"civilian_targeting":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"civilian_targeting_label":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"article_count":{"type":"number"}},"required":["id","url","title","story_date","article_count"]}},"entity_refs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]}},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain_avatar_url":{"oneOf":[{"type":"string"},{"type":"null"}]},"rank":{"type":"number"}},"required":["url","title","domain","domain_avatar_url","rank"]}},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string"},"count":{"type":"number"}},"required":["language","count"]}},"top_language":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_date":{"type":"string"},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one."},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the event, 0 to 1, higher is closer. It is a similarity, not a probability. The server drops semantic matches below a fixed relevance floor, so every semantic row returned is above it. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row carries the score of its semantic match when it also had one."}]},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests."},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered."},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity."},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder."},"role":{"oneOf":[{"type":"string"},{"type":"null"}]},"decision":{"type":"string","enum":["coverage"]},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching."},{"type":"null","description":"Reserved; null for coverage matching."}]},"resolution_confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"resolution_method":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence":{"oneOf":[{},{"type":"null"}]},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id."},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it."}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"]},"incident":{"type":"object","properties":{"uid":{"type":"string","description":"The incident key. Group or `uniqExact` on this instead of `event_uid` to count INCIDENTS rather than coded stories. Equal to `event_uid` unless a judge confirmed this event duplicates another, in which case it is the surviving event of the group. ALWAYS read `resolution` before trusting it: on an `unadjudicated` row this value is a fallback, not a verdict."},"resolution":{"type":"string","enum":["unadjudicated","self","llm"],"description":"How `uid` was decided. `unadjudicated` — this event was never compared to anything, and `uid` defaults to `event_uid`. `self` — compared and found unique. `llm` — an independent adversarial judge confirmed a duplicate and `uid` names the survivor. Coverage is deliberately partial and visible: only events that were candidates for a duplicate are ever adjudicated."},"confidence":{"oneOf":[{"type":"number","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge."},{"type":"null","description":"The judge's confidence in the merge, 0–1, and NULL unless `resolution` is `llm`. For a group of three or more this is the WEAKEST link that holds the group together, not the average — a group joined transitively is only as good as its worst edge."}]}},"required":["uid","resolution","confidence"]}},"required":["id","url","primary_story_url","family","title","title_source","summary","event_date","observed_at","event_date_basis","event_date_evidence","coded_at","updated_at","processed_at","category","subcategory","subcategory_label","event_description","taxonomy_status","domain","event_code","geo","geo_context","actors","metrics","has_fatalities","fatalities","fatalities_basis","fatalities_corroboration","fatalities_evidence","fatalities_supporting_source_count","injured","civilians_killed","civilians_injured","civilian_targeting","civilian_targeting_label","story_refs","entity_refs","top_articles","language_breakdown","top_language","search_score","incident"]},"description":"Optional geographic leads within radius_km; never proof of an incident at the site.","uniqueKey":"nearby_events.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_events","typeLabel":"object[] | null"},"nearby_stories":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].id","typeLabel":"string"},"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].recorded_at","typeLabel":"string"},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].published_at","typeLabel":"string"},"url":{"oneOf":[{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title","typeLabel":"string | null"},"story_date":{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].story_date","typeLabel":"string"},"updated_at":{"oneOf":[{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].updated_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].updated_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].updated_at","typeLabel":"string | null"},"processed_at":{"oneOf":[{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].processed_at.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].processed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].processed_at","typeLabel":"string | null"},"category":{"oneOf":[{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].category.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].category.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].category","typeLabel":"string | null"},"category_code":{"oneOf":[{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].category_code.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].category_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].category_code","typeLabel":"string | null"},"subcategory":{"oneOf":[{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].subcategory.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].subcategory.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].subcategory","typeLabel":"string | null"},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.country","typeLabel":"string | null"},"region":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.region.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.region.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.region","typeLabel":"string | null"},"continent":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.continent.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.continent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.continent","typeLabel":"string | null"},"admin1":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.admin1.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.admin1.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.admin1","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.location.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.location","typeLabel":"string | null"},"latitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.latitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.latitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.latitude","typeLabel":"number | null"},"longitude":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.longitude.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.longitude.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.longitude","typeLabel":"number | null"},"geo_precision":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.geo_precision.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.geo_precision","typeLabel":"number | null"},"geo_precision_label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.geo_precision_label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo.geo_precision_label","typeLabel":"string | null"}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo","typeLabel":"object"},"geo_provenance":{"oneOf":[{"type":"object","properties":{"method":{"type":"string","enum":["representative_linked_event"],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.0.method","typeLabel":"enum\u003cstring>"},"event_id":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.0.event_id","typeLabel":"string"}},"required":["method","event_id"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"method":{"type":"string","enum":["representative_linked_event"]},"event_id":{"type":"string"}},"required":["method","event_id"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_provenance.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_provenance","typeLabel":"object | null"},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_context.location_country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_context.location_country","typeLabel":"string | null"},"actor_origin_countries":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.oneOf.0.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_context.actor_origin_countries","typeLabel":"string[] | null"}},"required":["location_country","actor_origin_countries"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].geo_context","typeLabel":"object"},"metrics":{"type":"object","properties":{"significance":{"type":"number","description":"How widely the Story was reported: its article count on a log scale, min(1, ln(1 + article_count) / ln(10001)), rounded to four decimals. 1 article scores 0.0753, 100 articles 0.5011, 1,000 articles 0.7501, and 10,000 or more 1. Its Events' importance is `max_linked_event_significance`.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.significance","typeLabel":"number"},"article_count":{"type":"number","description":"Articles the Story holds. One page is counted more than once when it arrived under URLs that differ only in http or https, a leading `www.`, trailing slashes or tracking parameters such as `utm_*`; GET /api/v2/stories/{story_id}/articles lists each page once, so it can return fewer articles.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.article_count","typeLabel":"number"},"linked_event_count":{"oneOf":[{"type":"number","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.linked_event_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.linked_event_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.linked_event_count","typeLabel":"number | null"},"max_linked_event_significance":{"oneOf":[{"type":"number","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.max_linked_event_significance.oneOf.0","typeLabel":"number"},{"type":"null","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.max_linked_event_significance.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.max_linked_event_significance","typeLabel":"number | null"},"civilian_targeting_event_count":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.civilian_targeting_event_count.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.civilian_targeting_event_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.civilian_targeting_event_count","typeLabel":"number | null"},"outlet_count":{"oneOf":[{"type":"number","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.outlet_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.outlet_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics.outlet_count","typeLabel":"number | null"}},"required":["significance","article_count","linked_event_count","max_linked_event_significance","civilian_targeting_event_count"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].metrics","typeLabel":"object"},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.recent_count","typeLabel":"number"},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Records in the baseline window; null when it could not be read.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_count","typeLabel":"number | null"},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.0","typeLabel":"number"},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.expected_count","typeLabel":"number | null"},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.0","typeLabel":"number"},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.change.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.change","typeLabel":"number | null"},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.score","typeLabel":"number"},"recent_start":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.recent_start","typeLabel":"string"},"recent_end":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.recent_end","typeLabel":"string"},"baseline_start":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_start","typeLabel":"string"},"baseline_end":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0.baseline_end","typeLabel":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].rising","typeLabel":"object | null"},"event_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means linked-Event evidence could not be read; event-derived counts, flags and arrays are null, not measured zero or empty.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].event_enrichment_status","typeLabel":"enum\u003cstring>"},"entity_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means Story entity evidence was not published; entity_refs is null rather than misleadingly empty.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_enrichment_status","typeLabel":"enum\u003cstring>"},"has_events":{"oneOf":[{"type":"boolean","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].has_events.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].has_events.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].has_events","typeLabel":"boolean | null"},"has_fatalities":{"oneOf":[{"type":"boolean","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].has_fatalities.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].has_fatalities.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].has_fatalities","typeLabel":"boolean | null"},"has_civilian_targeting":{"oneOf":[{"type":"boolean","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].has_civilian_targeting.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].has_civilian_targeting.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].has_civilian_targeting","typeLabel":"boolean | null"},"fatalities":{"oneOf":[{"type":"number","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`).","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].fatalities.oneOf.0","typeLabel":"number"},{"type":"null","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`).","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].fatalities.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].fatalities","typeLabel":"number | null"},"linked_events":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].id","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX].title","typeLabel":"string | null"}},"required":["id","title"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].linked_events.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title"]},"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].linked_events.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].linked_events","typeLabel":"object[] | null"},"entity_refs":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].name","typeLabel":"string"},"source_entity_ids":{"type":"array","items":{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].source_entity_ids.items.[INDEX]","typeLabel":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].source_entity_ids","typeLabel":"string[]"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.checked","typeLabel":"boolean"},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.is_public_official.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.is_public_official.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.is_public_official","typeLabel":"boolean | null"},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.status.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.status","typeLabel":"enum\u003cstring> | null"},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.total.oneOf.0","typeLabel":"number"},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.total","typeLabel":"number | null"},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].office_id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].name","typeLabel":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.0","typeLabel":"string"},{"type":"null","description":"Office jurisdiction, not citizenship.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].country_iso3.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].country_iso3","typeLabel":"string | null"},"status":{"type":"string","enum":["current","ended","unknown"],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"start_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].start_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].start_date","typeLabel":"string | null"},"end_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].end_date","typeLabel":"string | null"},"evidence_date":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].evidence_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].evidence_date","typeLabel":"string | null"},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].source_key","typeLabel":"string"},"url":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX].url","typeLabel":"string | null"}},"required":["source_key","url"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX].sources","typeLabel":"object[]"}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.offices","typeLabel":"object[]"},"truncated":{"type":"boolean","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official.truncated","typeLabel":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX].public_official","typeLabel":"object"}},"required":["id","name"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]},"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_refs","typeLabel":"object[] | null"},"matched_categories":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0.items.[INDEX].code","typeLabel":"string"},"label":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0.items.[INDEX].label","typeLabel":"string"}},"required":["code","label"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]},"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].matched_categories.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].matched_categories","typeLabel":"object[] | null"},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].url","typeLabel":"string"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].title","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].domain","typeLabel":"string | null"},"rank":{"type":"number","description":"Position in the Story's article ranking, 1 being the Story's anchor. GET /api/v2/stories/{story_id}/articles lists every article in the same ranking.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX].rank","typeLabel":"number"}},"required":["url","title","domain","rank"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_articles","typeLabel":"object[]"},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].language","typeLabel":"string"},"count":{"type":"number","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX].count","typeLabel":"number"}},"required":["language","count"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].language_breakdown.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].language_breakdown","typeLabel":"object[]"},"top_language":{"oneOf":[{"type":"string","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_language.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_language.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].top_language","typeLabel":"string | null"},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.entity","typeLabel":"string"},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.mode","typeLabel":"enum\u003cstring>"},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.via","typeLabel":"enum\u003cstring>"},"role":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.role.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.role.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.role","typeLabel":"string | null"},"decision":{"type":"string","enum":["coverage"],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.decision","typeLabel":"enum\u003cstring>"},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.0","typeLabel":"number"},{"type":"null","description":"Reserved; null for coverage matching.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.materiality_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.materiality_confidence","typeLabel":"number | null"},"resolution_confidence":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.resolution_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.resolution_confidence","typeLabel":"number | null"},"resolution_method":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.resolution_method.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.resolution_method","typeLabel":"string | null"},"evidence":{"oneOf":[{"isRequired":true},{"type":"null","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.evidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.evidence","typeLabel":"null"},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.story_date","typeLabel":"string"},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link.story_id","typeLabel":"string"}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].entity_link","typeLabel":"object"},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].search_score.oneOf.0","typeLabel":"number"},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].search_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].search_score","typeLabel":"number | null"},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].match_type","typeLabel":"enum\u003cstring>"},"title_history":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].title","typeLabel":"string"},"previous_title":{"type":"string","description":"The title it replaced.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].previous_title","typeLabel":"string"},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC).","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].changed_at","typeLabel":"string"},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"article_count":{"type":"number","description":"Articles the Story held when the title changed.","isRequired":true,"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX].article_count","typeLabel":"number"}},"required":["title","previous_title","changed_at","reason","article_count"],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title_history.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title_history.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`."},"previous_title":{"type":"string","description":"The title it replaced."},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC)."},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story."},"article_count":{"type":"number","description":"Articles the Story held when the title changed."}},"required":["title","previous_title","changed_at","reason","article_count"]},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title_history.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].title_history","typeLabel":"object[] | null"},"event_count":{"type":"number","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX].event_count","typeLabel":"number"}},"required":["id"],"description":"Story referenced by the returned Events, hydrated through the canonical Stories serving API with category, metrics and identity evidence when available. Not an exhaustive facility Story search.","uniqueKey":"nearby_stories.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"nearby_stories.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"recorded_at":{"type":"string","description":"First committed availability time for the matching publication; present for recorded-interval queries."},"published_at":{"type":"string","description":"Original publication timestamp; present for recorded-interval queries."},"id":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"story_date":{"type":"string"},"updated_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"processed_at":{"oneOf":[{"type":"string"},{"type":"null"}]},"category":{"oneOf":[{"type":"string"},{"type":"null"}]},"category_code":{"oneOf":[{"type":"string"},{"type":"null"}]},"subcategory":{"oneOf":[{"type":"string"},{"type":"null"}]},"geo":{"type":"object","properties":{"country":{"oneOf":[{"type":"string"},{"type":"null"}]},"region":{"oneOf":[{"type":"string"},{"type":"null"}]},"continent":{"oneOf":[{"type":"string"},{"type":"null"}]},"admin1":{"oneOf":[{"type":"string"},{"type":"null"}]},"location":{"oneOf":[{"type":"string"},{"type":"null"}]},"latitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"longitude":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision":{"oneOf":[{"type":"number"},{"type":"null"}]},"geo_precision_label":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["country","region","continent","admin1","location","latitude","longitude","geo_precision","geo_precision_label"]},"geo_provenance":{"oneOf":[{"type":"object","properties":{"method":{"type":"string","enum":["representative_linked_event"]},"event_id":{"type":"string"}},"required":["method","event_id"]},{"type":"null","properties":{"method":{"type":"string","enum":["representative_linked_event"]},"event_id":{"type":"string"}},"required":["method","event_id"]}]},"geo_context":{"type":"object","properties":{"location_country":{"oneOf":[{"type":"string"},{"type":"null"}]},"actor_origin_countries":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}},"required":["location_country","actor_origin_countries"]},"metrics":{"type":"object","properties":{"significance":{"type":"number","description":"How widely the Story was reported: its article count on a log scale, min(1, ln(1 + article_count) / ln(10001)), rounded to four decimals. 1 article scores 0.0753, 100 articles 0.5011, 1,000 articles 0.7501, and 10,000 or more 1. Its Events' importance is `max_linked_event_significance`."},"article_count":{"type":"number","description":"Articles the Story holds. One page is counted more than once when it arrived under URLs that differ only in http or https, a leading `www.`, trailing slashes or tracking parameters such as `utm_*`; GET /api/v2/stories/{story_id}/articles lists each page once, so it can return fewer articles."},"linked_event_count":{"oneOf":[{"type":"number","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable."},{"type":"null","description":"Events linked to the Story that match your place and category filters. Null when linked-Event evidence is unavailable."}]},"max_linked_event_significance":{"oneOf":[{"type":"number","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable."},{"type":"null","description":"The highest `significance` among those linked Events; 0 when there are none, null when linked-Event evidence is unavailable."}]},"civilian_targeting_event_count":{"oneOf":[{"type":"number"},{"type":"null"}]},"outlet_count":{"oneOf":[{"type":"number","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it."},{"type":"null","description":"Distinct outlets that reported the Story: what sort=spread ranks by. Null when the row source does not carry it."}]}},"required":["significance","article_count","linked_event_count","max_linked_event_significance","civilian_targeting_event_count"]},"rising":{"oneOf":[{"type":"object","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor."},{"type":"null","properties":{"recent_count":{"type":"number","description":"Records in the recent window."},"baseline_count":{"oneOf":[{"type":"number","description":"Records in the baseline window; null when it could not be read."},{"type":"null","description":"Records in the baseline window; null when it could not be read."}]},"expected_count":{"oneOf":[{"type":"number","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."},{"type":"null","description":"Baseline scaled by the corpus: what the recent window would hold at the baseline share."}]},"change":{"oneOf":[{"type":"number","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."},{"type":"null","description":"recent_count ÷ expected_count; null when the baseline expected less than half a record."}]},"score":{"type":"number","description":"(recent − expected) ÷ √(expected + 4). The rank key."},"recent_start":{"type":"string"},"recent_end":{"type":"string"},"baseline_start":{"type":"string"},"baseline_end":{"type":"string"}},"required":["recent_count","baseline_count","expected_count","change","score","recent_start","recent_end","baseline_start","baseline_end"],"description":"Only with sort=rising: the Story's articles in the window against its thread's previous seven days; null below the recent floor."}]},"event_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means linked-Event evidence could not be read; event-derived counts, flags and arrays are null, not measured zero or empty."},"entity_enrichment_status":{"type":"string","enum":["available","unavailable"],"description":"Unavailable means Story entity evidence was not published; entity_refs is null rather than misleadingly empty."},"has_events":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"has_fatalities":{"oneOf":[{"type":"boolean","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable."},{"type":"null","description":"True when `fatalities` is above 0, false when it is 0. Null when `fatalities` is null: the Story links no conflict Event matching your filters (CAMEO+ records no deaths), or linked-Event evidence is unavailable."}]},"has_civilian_targeting":{"oneOf":[{"type":"boolean"},{"type":"null"}]},"fatalities":{"oneOf":[{"type":"number","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`)."},{"type":"null","description":"Deaths reported by the Story's linked conflict Events that match your place and category filters, summed. 0 when those Events report none. Null when the Story links no such conflict Event, including a Story whose Events are all CAMEO+ (that family records no deaths), and when linked-Event evidence is unavailable (`event_enrichment_status`)."}]},"linked_events":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title"]}},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title"]}}]},"entity_refs":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]}},{"type":"null","items":{"type":"object","properties":{"id":{"type":"string"},"source_entity_ids":{"type":"array","items":{"type":"string"},"description":"Original reference handles folded through published identity evidence. Names alone never establish equivalence."},"name":{"type":"string"},"public_official":{"type":"object","properties":{"checked":{"type":"boolean","description":"False when office evidence or canonical identity could not be checked."},"is_public_official":{"oneOf":[{"type":"boolean","description":"Published office evidence exists. Null means unavailable, not a negative finding."},{"type":"null","description":"Published office evidence exists. Null means unavailable, not a negative finding."}]},"status":{"oneOf":[{"type":"string","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."},{"type":"null","enum":["current","former","unknown"],"description":"Publisher status across recorded terms. Former requires all terms to be explicitly ended; missing dates never infer status."}]},"total":{"oneOf":[{"type":"number","description":"Distinct recorded offices, independent of the bounded preview."},{"type":"null","description":"Distinct recorded offices, independent of the bounded preview."}]},"offices":{"type":"array","items":{"type":"object","properties":{"office_id":{"type":"string"},"name":{"type":"string"},"country_iso3":{"oneOf":[{"type":"string","description":"Office jurisdiction, not citizenship."},{"type":"null","description":"Office jurisdiction, not citizenship."}]},"status":{"type":"string","enum":["current","ended","unknown"]},"start_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"end_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence_date":{"oneOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"source_key":{"type":"string"},"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["source_key","url"]}}},"required":["office_id","name","country_iso3","status","start_date","end_date","evidence_date","sources"]}},"truncated":{"type":"boolean"}},"required":["checked","is_public_official","status","total","offices","truncated"]}},"required":["id","name"]}}]},"matched_categories":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]}},{"type":"null","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"}},"required":["code","label"]}}]},"top_articles":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"domain":{"oneOf":[{"type":"string"},{"type":"null"}]},"rank":{"type":"number","description":"Position in the Story's article ranking, 1 being the Story's anchor. GET /api/v2/stories/{story_id}/articles lists every article in the same ranking."}},"required":["url","title","domain","rank"]}},"language_breakdown":{"type":"array","items":{"type":"object","properties":{"language":{"type":"string"},"count":{"type":"number"}},"required":["language","count"]}},"top_language":{"oneOf":[{"type":"string"},{"type":"null"}]},"entity_link":{"type":"object","properties":{"entity":{"type":"string","description":"The entity handle AS RESOLVED — the canonical id the scope actually used, which is not necessarily the string you sent (`entities=` takes the first member; ids are decoded and collapsed through the arbiter). Echoed so a caller passing several handles can tell which one answered."},"mode":{"type":"string","enum":["coverage"],"description":"The effective entity-match policy: coverage through Stories mentioning or linking the entity."},"via":{"type":"string","enum":["story","office"],"description":"The row qualifies through Story co-occurrence, not an assertion that the entity acted in the Event. `office` means it was reached through an OFFICE-HOLDER of the `office=` sent; `entity` then names the holder."},"role":{"oneOf":[{"type":"string"},{"type":"null"}]},"decision":{"type":"string","enum":["coverage"]},"materiality_confidence":{"oneOf":[{"type":"number","description":"Reserved; null for coverage matching."},{"type":"null","description":"Reserved; null for coverage matching."}]},"resolution_confidence":{"oneOf":[{"type":"number"},{"type":"null"}]},"resolution_method":{"oneOf":[{"type":"string"},{"type":"null"}]},"evidence":{"oneOf":[{},{"type":"null"}]},"story_id":{"type":"string","description":"The story that carried the entity — retrieve it at `/api/v2/stories/{story_id}` to read the evidence yourself. This is the most recent story linking the entity to this event. In ~0.2% of cases (measured over 3 production days: 17 of 8,295) the story has since been merged away, and that endpoint answers `STORY_MERGED` carrying the surviving id."},"story_date":{"type":"string","description":"The story's cluster date, `YYYY-MM-DD`. Pass it as `date=` alongside `story_id` — the story endpoints are date-partitioned and resolving the date costs an extra lookup without it."}},"required":["entity","mode","via","role","decision","materiality_confidence","resolution_confidence","resolution_method","evidence","story_date"]},"search_score":{"oneOf":[{"type":"number","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match."},{"type":"null","description":"Semantic relevance for a `search=` request: one minus the cosine distance between your text and the average of the Story's articles, 0 to 1, higher is closer. It is a similarity, not a probability. Story scores sit close together whatever the query, so no score separates on-topic from off-topic Stories: read the titles, or narrow with `category`, `country` or `entity`. NULL when the request had no `search=` and on a `match_type: \"entity\"` row; a `match_type: \"name\"` row can carry the score of its semantic match."}]},"match_type":{"type":"string","enum":["semantic","name","entity"],"description":"How this row was retrieved by `search=`: `semantic` (embedding similarity, carries a `search_score`), `name` (literal match; it can carry the score of its semantic match) or `entity` (linked to a person or organisation the search text names, `search_score` is null). Absent entirely on non-search requests."},"title_history":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`."},"previous_title":{"type":"string","description":"The title it replaced."},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC)."},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story."},"article_count":{"type":"number","description":"Articles the Story held when the title changed."}},"required":["title","previous_title","changed_at","reason","article_count"]},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses."},{"type":"null","items":{"type":"object","properties":{"title":{"type":"string","description":"The title the Story took at `changed_at`."},"previous_title":{"type":"string","description":"The title it replaced."},"changed_at":{"type":"string","description":"When the title changed (ISO 8601, UTC)."},"reason":{"type":"string","enum":["coverage_moved","status_split"],"description":"`coverage_moved`: most of the Story's headlines came to report a different subject or a later state than its title. `status_split`: a later state was restored as its own Story."},"article_count":{"type":"number","description":"Articles the Story held when the title changed."}},"required":["title","previous_title","changed_at","reason","article_count"]},"description":"Story detail only: every change of the Story's title, oldest first. `[]` when the Story kept its first title; null when the history could not be read. Absent from list responses."}]},"event_count":{"type":"number"}},"required":["id"],"description":"Story referenced by the returned Events, hydrated through the canonical Stories serving API with category, metrics and identity evidence when available. Not an exhaustive facility Story search."},"uniqueKey":"nearby_stories.oneOf.1","typeLabel":"null"}],"uniqueKey":"nearby_stories","typeLabel":"object[] | null"}},"required":["success","facility","window","owner","owner_events","owner_stories","owner_footprint","summary","next_steps","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"example":{"title":"example","summary":"Example response","value":{"success":true,"data":{"facility":{"facility_id":"f_4fbf12b61b2f45a9","name":"Example Power Station","country":"USA","latitude":40.71,"longitude":-74.01},"events":[],"entities":[]},"meta":{"coverage":{"events_measured":0},"window":{"days":30}}}}},"exampleType":"examples"}},"exampleType":"examples"},"8c05dcca-3e3a-4d7b-9430-27aeb120fc02":{"description":"Invalid parameter","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"d15f3a53-4fb8-4fd8-a316-a3cebd5a1dc9":{"description":"Missing or invalid API key","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"0675b310-e56e-4db2-a55a-a51744f190ab":{"description":"Plan does not include this surface","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"e51df802-26fa-41e9-9136-f3ac107a010f":{"description":"Quota or rate limit exceeded","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"86532b00-e5a0-421e-93b2-1c3f6d82a5be":{"description":"Server error","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"3a70df74-453c-4e46-8aff-db8b2e278117":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"gdelt_sk_...","description":"GDELT Cloud API key. Send as `Authorization: Bearer gdelt_sk_...`.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"d28bc35b-fd47-4d2b-a0a5-d865b3182cd8":{"url":"https://gdeltcloud.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"gdelt_sk_...","description":"GDELT Cloud API key. Send as `Authorization: Bearer gdelt_sk_...`.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"GDELT Cloud API key. Send as `Authorization: Bearer gdelt_sk_...`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi-v2.json"},"subdomain":"gdeltcloud","siteName":"GDELT Cloud","title":"Facility context - GDELT Cloud","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T20:45:13.443Z","originalFileLocation":"api-reference/facilities/facility-context.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"A facility fused with its OWNER\u0026#x27;s media coverage, plus optional nearby reporting and government exposure. Returns owner_events — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are null rather than empty, so \u0026quot;we did not look\u0026quot; is never mistaken for \u0026quot;we looked and found nothing\u0026quot;. Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage. These return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it. - as_of → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: /api/v2/intelligence/gpr?as_of=, /api/v2/macro/*?as_of=.\">\u003cmeta data-mint-head name=\"keywords\" content=\"GDELT Cloud, geopolitical risk API, global event data API, structured event data, GDELT alternative, news API, MCP server for events, conflict event data, OSINT data API, energy asset data, entity resolution\">\u003cmeta data-mint-head name=\"application-name\" content=\"GDELT Cloud\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Facility context - GDELT Cloud\">\u003cmeta data-mint-head property=\"og:description\" content=\"A facility fused with its OWNER\u0026#x27;s media coverage, plus optional nearby reporting and government exposure. Returns owner_events — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are null rather than empty, so \u0026quot;we did not look\u0026quot; is never mistaken for \u0026quot;we looked and found nothing\u0026quot;. Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage. These return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it. - as_of → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: /api/v2/intelligence/gpr?as_of=, /api/v2/macro/*?as_of=.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GDELT Cloud\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gdeltcloud.mintlify.site/_mintlify/api/og/v2?division=Facilities\u0026amp;title=Facility+context\u0026amp;description=A+facility+fused+with+its+OWNER%27s+media+coverage%2C+plus+optional+nearby+reporting+and+government+exposure.+Returns+%60owner_events%60+%E2%80%94+events+about+the+owner%2C+NOT+e\u0026amp;theme=8c78b2ca5d901664824fc4fc\u0026amp;signature=7bf038e40a9bcc9329bb4442366a4fac018ba5e4fd50a8eefdc15a9af402bb72\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Facility context - GDELT Cloud\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A facility fused with its OWNER\u0026#x27;s media coverage, plus optional nearby reporting and government exposure. Returns owner_events — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are null rather than empty, so \u0026quot;we did not look\u0026quot; is never mistaken for \u0026quot;we looked and found nothing\u0026quot;. Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage. These return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it. - as_of → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: /api/v2/intelligence/gpr?as_of=, /api/v2/macro/*?as_of=.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gdeltcloud.mintlify.site/_mintlify/api/og/v2?division=Facilities\u0026amp;title=Facility+context\u0026amp;description=A+facility+fused+with+its+OWNER%27s+media+coverage%2C+plus+optional+nearby+reporting+and+government+exposure.+Returns+%60owner_events%60+%E2%80%94+events+about+the+owner%2C+NOT+e\u0026amp;theme=8c78b2ca5d901664824fc4fc\u0026amp;signature=7bf038e40a9bcc9329bb4442366a4fac018ba5e4fd50a8eefdc15a9af402bb72\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/gdeltcloud/H_neREbzalCPTNtu/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GDELT Cloud\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00A3E6\">\u003cmeta data-mint-head name=\"author\" content=\"GDELT Cloud\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/facilities/facility-context.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gdeltcloud.com/#organization\",\"name\":\"GDELT Cloud\",\"url\":\"https://docs.gdeltcloud.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gdeltcloud/KTGJpOMcmte0oOTe/logo/light.png?fit=max\u0026auto=format\u0026n=KTGJpOMcmte0oOTe\u0026q=85\u0026s=a78b03b47abd8cab8440d155ed680c34\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gdeltcloud.com#website\",\"name\":\"GDELT Cloud\",\"url\":\"https://docs.gdeltcloud.com\",\"publisher\":{\"@id\":\"https://docs.gdeltcloud.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context#webpage\",\"url\":\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context\",\"name\":\"Facility context\",\"description\":\"A facility fused with its OWNER's media coverage, plus optional nearby reporting and government exposure. Returns owner_events — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are null rather than empty, so \\\"we did not look\\\" is never mistaken for \\\"we looked and found nothing\\\". Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage. These return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it. - as_of → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: /api/v2/intelligence/gpr?as_of=, /api/v2/macro/*?as_of=.\",\"dateModified\":\"2026-11-20T20:45:13.443Z\",\"isPartOf\":{\"@id\":\"https://docs.gdeltcloud.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Facilities\",\"item\":\"https://docs.gdeltcloud.com/api-reference/facilities/search-facilities\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Facility context\",\"item\":\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context#apireference\",\"headline\":\"Facility context\",\"name\":\"Facility context\",\"description\":\"A facility fused with its OWNER's media coverage, plus optional nearby reporting and government exposure. Returns owner_events — events about the owner, NOT events located at the site. When the owner cannot be resolved or cannot be bridged to the news layer, the arrays are null rather than empty, so \\\"we did not look\\\" is never mistaken for \\\"we looked and found nothing\\\". Coverage unions the checked owners or their recorded parents, preserving typed paths, stakes and sources in owner.coverage_paths; a minority ownership path does not establish control. Summary counts describe the returned Event preview and its linked Stories, not all matches. Multiple coverage entities leave the legacy singular owner id/name null; optional government footprints are not aggregated across them. Oversized or unavailable scopes are reported explicitly. Name-only owners receive separate reported_owner_matches and reported_owner_events/stories when an exact reference name or alias identifies one entity. This best-effort discovery never verifies ownership or changes resolved-owner coverage. These return a 400 naming the reason and the alternative, so a filter that cannot work fails loudly instead of returning rows that ignore it. - as_of → 400 UNSUPPORTED_PARAM. Facility ownership is not vintaged — the directory records the latest known owner and prior owners are not yet reconstructable as-of, so an as_of result here would not be reproducible. Use instead: /api/v2/intelligence/gpr?as_of=, /api/v2/macro/*?as_of=.\",\"url\":\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gdeltcloud.com/api-reference/facilities/facility-context#webpage\"},\"dateModified\":\"2026-11-20T20:45:13.443Z\",\"publisher\":{\"@id\":\"https://docs.gdeltcloud.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gdeltcloud.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GDELT Cloud\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"GDELT Cloud\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/facilities/facility-context.md","siteName":"GDELT Cloud","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Events","pages":[{"title":"Search Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/events","href":"/api-reference/events/search-events"},{"title":"Get Event","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/events/{event_id}","href":"/api-reference/events/get-event"},{"title":"Get Event Stories","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/events/{event_id}/stories","href":"/api-reference/events/get-event-stories"},{"title":"Summarize Events","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/events/summary","href":"/api-reference/events/summarize-events"}]},{"group":"Stories","pages":[{"title":"Search Stories","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/stories","href":"/api-reference/stories/search-stories"},{"title":"Get Story","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/stories/{story_id}","href":"/api-reference/stories/get-story"},{"title":"Get Story Articles","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/stories/{story_id}/articles","href":"/api-reference/stories/get-story-articles"},{"title":"Summarize Stories","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/stories/summary","href":"/api-reference/stories/summarize-stories"}]},{"group":"Situations","pages":[{"title":"List Situations","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations","href":"/api-reference/situations/list-situations"},{"title":"Create or expand a shared Situation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/situations","href":"/api-reference/situations/create-or-expand-a-shared-situation"},{"title":"Get a Situation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}","href":"/api-reference/situations/get-a-situation"},{"title":"List all linked entities in a stored Situation","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/entities","href":"/api-reference/situations/list-all-linked-entities-in-a-stored-situation"},{"title":"List a Situation's stories","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/stories","href":"/api-reference/situations/list-a-situations-stories"},{"title":"List a Situation's events","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/events","href":"/api-reference/situations/list-a-situations-events"},{"title":"List Situation membership connections chronologically","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/connections","href":"/api-reference/situations/list-situation-membership-connections-chronologically"},{"title":"Read a retained Situation brief","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/brief","href":"/api-reference/situations/read-a-retained-situation-brief"},{"title":"List retained Situation editions","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/situations/{story_id}/editions","href":"/api-reference/situations/list-retained-situation-editions"}]},{"group":"Entities","pages":[{"title":"Discover entities in reporting","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities","href":"/api-reference/entities/discover-entities-in-reporting"},{"title":"Get Entity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}","href":"/api-reference/entities/get-entity"},{"title":"Corporate hierarchy for a resolved entity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}/hierarchy","href":"/api-reference/entities/corporate-hierarchy-for-a-resolved-entity"},{"title":"Entity Dossier — the statecraft timeline","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}/dossier","href":"/api-reference/entities/entity-dossier-—-the-statecraft-timeline"},{"title":"Read publication activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/activity","href":"/api-reference/entities/read-publication-activity"},{"title":"Share of Voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/share-of-voice","href":"/api-reference/entities/share-of-voice"},{"title":"Entity Interactions — who it acts on, and who acts on it","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}/interactions","href":"/api-reference/entities/entity-interactions-—-who-it-acts-on-and-who-acts-on-it"}]},{"group":"Unified Search","pages":[{"title":"Unified cross-source entity search","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/search","href":"/api-reference/unified-search/unified-cross-source-entity-search"}]},{"group":"Media Intelligence","pages":[{"title":"Entity tone","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entity-tone","href":"/api-reference/media-intelligence/entity-tone"}]},{"group":"Facilities","pages":[{"title":"Search Facilities","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities","href":"/api-reference/facilities/search-facilities"},{"title":"Get Facility","description":"Returns a canonical physical site with unit count, unit identifiers and status breakdown. A legacy registry-unit id resolves to the same parent site.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}","href":"/api-reference/facilities/get-facility"},{"title":"Facility context","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}/context","href":"/api-reference/facilities/facility-context"},{"title":"Facility relationships","description":"Evidence-backed physical hierarchy in data and participant assertions in participants. Each collection has independent pagination; follow pagination.next_cursor for links and meta.participant_pagination.next_cursor for participants using offset. Reported and probable claims are usable by default. Installations, campuses and clusters remain distinct assets. This Facilities surface includes participant roles and physical links; deep compute and finance observations have separately gated endpoints.","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}/relationships","href":"/api-reference/facilities/facility-relationships"},{"title":"Facility source observations","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facilities/{facility_id}/observations","href":"/api-reference/facilities/facility-source-observations"},{"title":"Inspect a bounded Facilities example","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/facility-examples/{slug}","href":"/api-reference/facilities/inspect-a-bounded-facilities-example"}]},{"group":"Monitors","pages":[{"title":"List Monitors","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors","href":"/api-reference/monitors/list-monitors"},{"title":"Create Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors","href":"/api-reference/monitors/create-monitor"},{"title":"Get Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}","href":"/api-reference/monitors/get-monitor"},{"title":"Delete Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json delete /api/v2/monitors/{id}","href":"/api-reference/monitors/delete-monitor"},{"title":"Update Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json patch /api/v2/monitors/{id}","href":"/api-reference/monitors/update-monitor"},{"title":"Preview Monitor","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/preview","href":"/api-reference/monitors/preview-monitor"},{"title":"Batch enable, pause, or delete","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/batch","href":"/api-reference/monitors/batch-enable-pause-or-delete"},{"title":"List triggered Monitor runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}/runs","href":"/api-reference/monitors/list-triggered-monitor-runs"},{"title":"Get a triggered Monitor run","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}/runs/{runId}","href":"/api-reference/monitors/get-a-triggered-monitor-run"},{"title":"Send a test webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/{id}/test-delivery","href":"/api-reference/monitors/send-a-test-webhook"},{"title":"Page a run's matched items","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}/runs/{runId}/matches","href":"/api-reference/monitors/page-a-runs-matched-items"},{"title":"Export a run's matched items as CSV","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/monitors/{id}/runs/{runId}/matches.csv","href":"/api-reference/monitors/export-a-runs-matched-items-as-csv"},{"title":"Run a saved Monitor now","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/{id}/run-now","href":"/api-reference/monitors/run-a-saved-monitor-now"},{"title":"Try a signed demo webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/monitors/demo-webhook","href":"/api-reference/monitors/try-a-signed-demo-webhook"}]},{"group":"Saved Queries","pages":[{"title":"List saved queries","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/saved-queries","href":"/api-reference/saved-queries/list-saved-queries"},{"title":"Save a query","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json post /api/v2/saved-queries","href":"/api-reference/saved-queries/save-a-query"},{"title":"Get a saved query","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/saved-queries/{id}","href":"/api-reference/saved-queries/get-a-saved-query"},{"title":"Delete a saved query","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json delete /api/v2/saved-queries/{id}","href":"/api-reference/saved-queries/delete-a-saved-query"},{"title":"Update a saved query","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json patch /api/v2/saved-queries/{id}","href":"/api-reference/saved-queries/update-a-saved-query"}]},{"group":"Geography","pages":[{"title":"List Admin1 Values","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/geo/admin1","href":"/api-reference/geography/list-admin1-values"},{"title":"Read country activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/countries","href":"/api-reference/geography/read-country-activity"},{"title":"Get country context","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/countries/{iso3}","href":"/api-reference/geography/get-country-context"}]},{"group":"Government","pages":[{"title":"Federal Awards (USAspending)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gov/awards","href":"/api-reference/government/federal-awards-usaspending"},{"title":"Foreign Agents (FARA)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gov/fara","href":"/api-reference/government/foreign-agents-fara"}]},{"group":"Political Offices","pages":[{"title":"List Offices","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/offices","href":"/api-reference/political-offices/list-offices"},{"title":"Get Office","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/offices/{office_id}","href":"/api-reference/political-offices/get-office"},{"title":"List Office Holders","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/offices/{office_id}/holders","href":"/api-reference/political-offices/list-office-holders"},{"title":"List Entity Offices","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/entities/{entity_id}/offices","href":"/api-reference/political-offices/list-entity-offices"}]},{"group":"Filings","pages":[{"title":"List SEC filings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings","href":"/api-reference/filings/list-sec-filings"},{"title":"Summarize filings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/summary","href":"/api-reference/filings/summarize-filings"},{"title":"Material events (8-K)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/events","href":"/api-reference/filings/material-events-8-k"},{"title":"Filer profile","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/{cik}","href":"/api-reference/filings/filer-profile"},{"title":"Filer relations (LLM)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/{cik}/relations","href":"/api-reference/filings/filer-relations-llm"},{"title":"Filer XBRL facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/{cik}/facts","href":"/api-reference/filings/filer-xbrl-facts"},{"title":"Resolve to CIK","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/resolve","href":"/api-reference/filings/resolve-to-cik"},{"title":"Filers that name a company","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/filings/relations","href":"/api-reference/filings/filers-that-name-a-company"}]},{"group":"Reference Data","pages":[{"title":"GLEIF legal entities (Open Feed)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/entities","href":"/api-reference/reference-data/gleif-legal-entities-open-feed"},{"title":"One GLEIF entity, with its relationships and ISINs","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/entities/{lei}","href":"/api-reference/reference-data/one-gleif-entity-with-its-relationships-and-isins"},{"title":"GLEIF Level-2 relationships","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/relationships","href":"/api-reference/reference-data/gleif-level-2-relationships"},{"title":"LEI ↔ ISIN mappings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/gleif/isin","href":"/api-reference/reference-data/lei-↔-isin-mappings"}]},{"group":"Energy","pages":[{"title":"Search Energy Assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/assets","href":"/api-reference/energy/search-energy-assets"},{"title":"Summarize Energy Assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/assets/summary","href":"/api-reference/energy/summarize-energy-assets"},{"title":"Get Energy Asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/assets/{tracker}/{gem_id}","href":"/api-reference/energy/get-energy-asset"},{"title":"Search Energy Owners","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/owners","href":"/api-reference/energy/search-energy-owners"},{"title":"Get Energy Owner","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/energy/owners/{entity_id}","href":"/api-reference/energy/get-energy-owner"}]},{"group":"Macro Finance","pages":[{"title":"List FRED series","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/macro/series","href":"/api-reference/macro-finance/list-fred-series"},{"title":"Get FRED series detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/macro/series/{series_id}","href":"/api-reference/macro-finance/get-fred-series-detail"},{"title":"List FRED observations","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/macro/observations","href":"/api-reference/macro-finance/list-fred-observations"},{"title":"List FRED releases","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/macro/releases","href":"/api-reference/macro-finance/list-fred-releases"}]},{"group":"Screening and Reference","pages":[{"title":"Screen a counterparty","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/screening/match","href":"/api-reference/screening-and-reference/screen-a-counterparty"},{"title":"Ownership-chain exposure","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/exposure","href":"/api-reference/screening-and-reference/ownership-chain-exposure"},{"title":"List catalog","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/lists","href":"/api-reference/screening-and-reference/list-catalog"},{"title":"Search list entries","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/lists/entries","href":"/api-reference/screening-and-reference/search-list-entries"},{"title":"List change feed","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/lists/changes","href":"/api-reference/screening-and-reference/list-change-feed"}]},{"group":"Maritime","pages":[{"title":"Chokepoint transit activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/transits","href":"/api-reference/maritime/chokepoint-transit-activity"},{"title":"Current vessels (last-known)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/vessels","href":"/api-reference/maritime/current-vessels-last-known"},{"title":"Chokepoint dwell episodes","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/dwell","href":"/api-reference/maritime/chokepoint-dwell-episodes"},{"title":"AIS-dark gaps","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/gaps","href":"/api-reference/maritime/ais-dark-gaps"},{"title":"Ports reference","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/ports","href":"/api-reference/maritime/ports-reference"},{"title":"Port disruption pulse","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/port-pulse","href":"/api-reference/maritime/port-disruption-pulse"},{"title":"Chokepoint risk watch","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/maritime/chokepoint-watch","href":"/api-reference/maritime/chokepoint-risk-watch"}]},{"group":"Atlas Intelligence","pages":[{"title":"Atlas GPR — geopolitical risk vs a place’s own normal","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/intelligence/gpr","href":"/api-reference/atlas-intelligence/atlas-gpr-—-geopolitical-risk-vs-a-place’s-own-normal"},{"title":"Atlas Posture — country condition and annual context","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/intelligence/posture","href":"/api-reference/atlas-intelligence/atlas-posture-—-country-condition-and-annual-context"},{"title":"Atlas coverage — where the index can and cannot be read","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/intelligence/coverage","href":"/api-reference/atlas-intelligence/atlas-coverage-—-where-the-index-can-and-cannot-be-read"}]},{"group":"Natural Resources","pages":[{"title":"Natural-resource statistics","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/resources/statistics","href":"/api-reference/natural-resources/natural-resource-statistics"}]},{"group":"Meta","pages":[{"title":"Value vocabularies, machine-readable","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/meta/enums","href":"/api-reference/meta/value-vocabularies-machine-readable"},{"title":"Endpoint contracts, machine-readable","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/meta/endpoints","href":"/api-reference/meta/endpoint-contracts-machine-readable"},{"title":"What a call costs, and what your plan allows","deprecated":null,"version":null,"openapi":"/api-reference/openapi-v2.json get /api/v2/meta/query-units","href":"/api-reference/meta/what-a-call-costs-and-what-your-plan-allows"}]}]},{"tab":"Data Reference","pages":[{"title":"Data Reference","href":"/reference"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"basePath":"","title":"Facility context - GDELT Cloud","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BtG4DSkw.js","snippetPresets-C1k1xDhp.js","utils-PMJoEt4Y.js","style-to-object-BY3JEAdk.js","utils-DW3Pr7Jq.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DIISLO2w.js","conditional-requirements-CFM0id0Q.js","cloneDeep-BErNCZCm.js","_Uint8Array-f0PCu9f_.js","isObject-FP1Yky1u.js","ApiExamples-OjY-8mqu.js","usePlaygroundInputsStore-B2HS2hUb.js","shallow-DVFuuIDQ.js","isEqual-DG0UKiQC.js","CodeSnippets-Cy6FBgwN.js","CodeSnippet-D1PtG8ed.js","getApiPlaygroundDisplay-Dkx2eNtL.js","Page-C8Cg25if.js","DynamicMarkdown-BvJIe00T.js","SectionHeading-B0rKYV8d.js","icon-yclzBff4.js","MethodPill-DxA11cCF.js","getPastedJson-CpkIDpMk.js","DuplicateIcon-CFCQNJ-D.js","axios-CsQoIw0U.js","Markdown-CK5C-fmV.js","AssistantPageLink-Cw134Dd-.js","dist-3xM3Qrc7.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}