Skip to main content
GET
Get Office

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Path Parameters

office_id
string
required

The office id.

Query Parameters

as_of
string<date>

VALID TIME — who HELD the office on this date (YYYY-MM-DD), read from the start/end dates the publisher states. This is NOT knowledge-time replay: it is not routed through the can_use_asof gate and does not answer "what did we know then". An office-holder with no published start date cannot be placed on a date and is EXCLUDED rather than guessed — meta.undated_office_holders counts how many the date could not see. A future date is accepted and reads as "still in office as far as the source has published".

Response

Success

success
enum<boolean>
required
Available options:
true
data
object
required
holders_preview
object[]
required
holders_truncated
boolean
required
holders_url
string
required
meta
object
required