Facility context
A facility fused with its OWNER’s media coverage, plus optional 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”.
Parameters this endpoint deliberately rejects (1)
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=.
Authorizations
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
The facility id.
Query Parameters
Owner-coverage window in days, max 30. Also accepts: window. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Explicit start of the owner-coverage window. Also accepts: start_date. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Explicit end of the owner-coverage window. Also accepts: end_date. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
Maximum owner events to attach. Default 10, max 50. Note: validation is owned by the endpoint service because it depends on composed or cross-parameter state; the published error semantics above still apply.
1 <= x <= 50Optional 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. Full value list: https://docs.gdeltcloud.com/reference/enums#facility_context_include
gov Response
Success