Entity Dossier — the statecraft timeline

curl --request GET \
  --url https://gdeltcloud.com/api/v2/entities/{entity_id}/dossier \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gdeltcloud.com/api/v2/entities/{entity_id}/dossier', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {}
}

Entities

Entity Dossier — the statecraft timeline

One Actor in, one time-ordered, cited chronology out: restricted-list designations as a change log (list_added / list_removed), public offices held (office_start / office_end), FARA foreign-agent registrations, federal awards and the coded event stream — resolved across BOTH identity universes (news wiki: and the spine e_) so events and government data fuse instead of one silently dropping. flags carries the cross-lane statecraft conjunctions (an office-holder who is listed, a designation that landed while in office, a sanctioned facility owner, a foreign agent for a sitting official) with receipts in flag_details. {entity_id} accepts a name, a spine e_ id, a wiki: id or a Wikipedia URL. With as_of every ingredient is valid-time filtered to on-or-before that date; offices use the office dates the source publishes. Unknown coverage is NULL, never a fabricated 0, and every item carries source_key, attribution, evidence_url and date_precision. Economic-statecraft INTELLIGENCE — not a compliance or screening control (see meta.disclaimer).

GET

api

entities

{entity_id}

dossier

Entity Dossier — the statecraft timeline

curl --request GET \
  --url https://gdeltcloud.com/api/v2/entities/{entity_id}/dossier \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://gdeltcloud.com/api/v2/entities/{entity_id}/dossier', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "data": {}
}

Authorizations

Authorization

string

header

required

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

Path Parameters

entity_id

string

required

The entity id.

Query Parameters

as_of

string<date>

Point-in-time dossier: every ingredient is valid-time filtered to facts dated on or before this date (no look-ahead); offices use the office start/end dates the source publishes. Absent = current knowledge. A past date needs can_use_asof. The three aliases are the spellings resolveAsOf honours everywhere else. Also accepts: realtime_start, vintage, knowledge_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.

event_days

integer

default:30

Trailing window for the coded-event ingredient, in days (1–30). summary.events_in_window counts over the same 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.

Required range: 1 <= x <= 30

Response

Success

entity

object

required

Show child attributes

timeline

object[]

required

Show child attributes

summary

object

required

Show child attributes

flags

enum<string>[]

required

Available options:

office_holder_and_listed,

current_office_holder_and_listed,

listed_while_in_office,

wanted_and_listed,

sanctioned_owner_of_facility,

foreign_agent_for_office_holder

flag_details

object

required

Show child attributes

Events

Stories

Entities

Unified Search

Media Intelligence

Facilities

Monitors

Geography

Government

Filings

Reference Data

Energy

AI Compute

Macro Finance

Screening and Reference

China

Maritime

Atlas Intelligence

Briefs

Meta

Entity Dossier — the statecraft timeline

Authorizations

Path Parameters

Query Parameters

Response