curl --request GET \
--url https://gdeltcloud.com/api/v2/entities/{entity_id}/dossier \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/entities/{entity_id}/dossier"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)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": {}
}Entity Dossier — the statecraft timeline
One Actor in, one time-ordered, cited chronology out: public-list membership evidence 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 — fusing news and registry records when a confirmed identity bridge exists. Missing bridges are disclosed in meta.coverage_note, with unmeasured coverage NULL. 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; the dossier does not return a facility inventory. {entity_id} accepts a name, a spine e_ id, a wiki: or llm: id or a Wikipedia URL. Confirm the intended parent, subsidiary or person in Search and reuse its identifier. With as_of dated facts are 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. List items also carry date_basis: publisher_listing uses a publisher-supplied listing date, first_observed uses our first observation, and observed_change uses our change-detection snapshot. An observed addition or removal is not a publisher designation or removal date. Legacy USAspending search records carry reported performance-start dates, explicitly labeled in the timeline, rather than award-action dates. Current memberships and identity links do not reconstruct a complete historical knowledge snapshot; meta.no_lookahead remains false. Reporting is linked-Story coverage, not proof of direct participation or material impact. Timeline items are bounded per source and summary totals may exceed the preview. Economic-statecraft INTELLIGENCE — not a compliance or screening control (see meta.disclaimer).
curl --request GET \
--url https://gdeltcloud.com/api/v2/entities/{entity_id}/dossier \
--header 'Authorization: Bearer <token>'import requests
url = "https://gdeltcloud.com/api/v2/entities/{entity_id}/dossier"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)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
GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....
Path Parameters
The entity id.
Query Parameters
Date-filtered dossier: ingredients are filtered to facts dated on or before this date; offices use the office start/end dates the source publishes. Identity and attribution still use current knowledge, so meta.no_lookahead remains false. 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.
Trailing calendar window including the end date, in days. summary.events_in_window and summary.stories_in_window count coded occurrences and coverage Stories separately using the public serving summaries; the Event timeline preview is. 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 <= 30Response
Success
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
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 Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes