> ## Documentation Index > Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Event > Fetch one known structured Event by ID. ## OpenAPI ````yaml /api-reference/openapi-v2.json get /api/v2/events/{event_id} openapi: 3.0.3 info: title: GDELT Cloud API v2 version: 2.0.0 description: >- Clean v2 REST API for generated GDELT Cloud structured Events, clustered Stories, linked Entities, summaries, admin1 discovery, significance ranking, and paginated article evidence. Event significance is a family-scoped weighted blend, renormalized so every event family spans a true 0-1: each event's raw total is divided by the maximum its own family can reach (Conflict 1.00, CAMEO+ POLITICAL 0.90, other CAMEO+ domains 0.65). All events: Goldstein severity 0.25, article evidence 0.05, confidence 0.05. Conflict only: fatalities 0.55 (log-scaled by body count) and civilian targeting 0.10. CAMEO+ only: magnitude 0.20, systemic importance 0.15, propagation potential 0.10, market sensitivity 0.10. When magnitude is unmeasured its term AND its 0.20 weight are both dropped. The four CAMEO+ metrics are rubric scores produced by published formulas - ordinal ranking signals, not measurements, probabilities, or predicted price moves. goldstein_scale is one canonical public metric, populated for Conflict Events and CAMEO+ POLITICAL Events where meaningful. Story linked_event_count is a Story-to-Event link aggregate, not a distinct Event total. servers: - url: https://gdeltcloud.com description: Production - url: http://localhost:3000 description: Local development security: - ApiKeyAuth: [] tags: - name: Events description: Coded CAMEO+ / conflict events — search, fetch, and summarize. - name: Stories description: Clustered narratives (stories) and their articles. - name: Entities description: >- People & organizations — resolve a name to an entity, then fetch its profile and tone. - name: Geography description: Admin-1 geography lookups. - name: Energy description: Global Energy Monitor assets + ownership registry. - name: Facilities description: >- Unified physical-asset directory — GEM energy assets + World Port Index ports + Epoch AI data centers on one keyed surface, resolved to spine owners. Plan-gated (Analyst plan and up). - name: Screening and Reference description: >- Restricted-party lists, screening, and ownership-chain exposure. Plan-gated (`can_use_screening` / `can_use_exposure`). - name: China description: >- China overseas development finance (AidData GCDF). Plan-gated (`can_use_china`). - name: Media Intelligence description: >- Entity tone (`can_use_tone`) and Share of Voice (`can_use_share_of_voice`) are plan-gated. Social signal remains an admin-only preview. - name: Filings description: >- SEC EDGAR filings, XBRL financials, and AI-extracted relations. Requires a plan with SEC filings access (`can_use_filings`) — the Corporate & Supply Chain plan and above. - name: Macro Finance description: >- FRED economic time series (catalog, point-in-time observations, releases). Plan-gated (`can_use_macro`). - name: Maritime description: >- AIS-derived vessel-flow signals across maritime chokepoints — chokepoint transits, last-known vessel positions, carriers, dwell, and AIS-dark gaps. Plan-gated (`can_use_maritime`). - name: Briefs description: Source-backed monitoring briefs. paths: /api/v2/events/{event_id}: get: tags: - Events summary: Get Event description: Fetch one known structured Event by ID. operationId: get-event-v2 parameters: - name: event_id in: path required: true description: >- Event ID returned by Search Events, for example `conflict_...` or `cameoplus_...`. schema: type: string responses: '200': description: Event detail content: application/json: schema: type: object properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/EventCard' examples: event: value: success: true data: id: conflict_13e29fd7 url: https://gdeltcloud.com/story/example-story primary_story_url: https://gdeltcloud.com/story/example-story family: conflict title: Attack in Delft summary: A conflict Event coded from linked source articles. event_date: '2026-04-15' category: Violence against civilians subcategory: Attack domain: CONFLICT event_code: conflict_13e29fd7 geo: country: South Africa region: Southern Africa continent: Africa admin1: Western Cape location: Delft latitude: -33.955 longitude: 18.634 actors: - name: Unknown armed actor country: null role: actor1 metrics: significance: 0.3585 goldstein_scale: -7 magnitude: null systemic_importance: null propagation_potential: null market_sensitivity: null confidence: 0.82 article_count: 1 has_fatalities: true fatalities: 4 story_refs: - id: story_123 url: https://gdeltcloud.com/story/example-story title: Delft mass shooting coverage story_date: '2026-04-15' article_count: 1 entity_refs: [] top_articles: - url: https://www.example.com/delft-mass-shooting title: 'Delft mass shooting: child among 4 killed' domain: example.com rank: 1 '404': $ref: '#/components/responses/NotFound' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: cURL source: |- curl "https://gdeltcloud.com/api/v2/events/conflict_13e29fd7" \ -H "Authorization: Bearer $GDELT_CLOUD_API_KEY" components: schemas: EventCard: type: object properties: id: type: string url: type: string format: uri nullable: true primary_story_url: type: string format: uri nullable: true family: $ref: '#/components/schemas/EventFamily' title: type: string nullable: true summary: type: string nullable: true image_url: type: string format: uri nullable: true description: >- First available top-article sharing image promoted to the Event card. event_date: type: string format: date category: type: string nullable: true subcategory: type: string nullable: true domain: type: string nullable: true event_code: type: string nullable: true geo: $ref: '#/components/schemas/Geo' geo_context: $ref: '#/components/schemas/GeoContext' actors: type: array items: type: object metrics: type: object properties: significance: type: number goldstein_scale: type: number nullable: true description: >- Canonical signed -10 to +10 Goldstein scale. Present for Conflict Events and CAMEO+ POLITICAL Events where meaningful; null for non-political CAMEO+ Events. It is the only public Goldstein metric on Event cards. magnitude: type: number nullable: true description: >- Intensity within the event's own domain, 0-10. Comparable WITHIN a domain only (a conflict 9 and a technology 9 are not the same size) - use `significance` to rank across domains. Four paths: conflict = min(10, 2 + 2*log10(deaths)); hazard, verbal and economic use anchored 0-10 tiers. `null` when no severity observable was found - null means UNKNOWN, not zero, and must never be coerced to 0. CAMEO+ events only. These four are rubric scores, not measurements: a hard registry observable resolves for ~2.2% of events. Treat them as ordinal ranking signals. systemic_importance: type: number nullable: true description: >- How much the wider system depends on the node this event touched: the equal-weighted mean of size, interconnectedness and irreplaceability, following Basel BCBS G-SIB and ECB O-SII practice. It is about the NODE, not the number of countries or people involved. Low base rate. CAMEO+ events only. These four are rubric scores, not measurements: a hard registry observable resolves for ~2.2% of events. Treat them as ordinal ranking signals. propagation_potential: type: number nullable: true description: >- The transmission conditions PRESENT NOW that would let a shock travel: the mean of channel, coupling, breach, primed and (1 - containment), returning 0 when no live channel exists. Adapted from the ERCS barrier model and Rinaldi-Peerenboom-Kelly dependency coupling. NOT a probability, NOT a forecast of follow-on events, and it carries no per-domain prior. CAMEO+ events only. These four are rubric scores, not measurements: a hard registry observable resolves for ~2.2% of events. Treat them as ordinal ranking signals. market_sensitivity: type: number nullable: true description: >- How much market-relevant information the event carries for a reasonable investor: the mean of claim_exposure and economic_bite, returning 0 when nothing traded is exposed. Adapted from the reasonable-investor materiality test (TSC v. Northway; MAR Art. 7(4)). An UNSIGNED ORDINAL RANKING SIGNAL - not a predicted price move, not a probability, not an expected return, and it indicates no direction. CAMEO+ events only. These four are rubric scores, not measurements: a hard registry observable resolves for ~2.2% of events. Treat them as ordinal ranking signals. confidence: type: number nullable: true article_count: type: integer has_fatalities: type: boolean fatalities: type: integer story_refs: type: array items: type: object entity_refs: type: array items: $ref: '#/components/schemas/EntityRef' top_articles: type: array maxItems: 3 items: $ref: '#/components/schemas/Article' civilian_targeting: type: boolean description: True when the Conflict Event has ACLED civilian_targeting populated. civilian_targeting_label: type: string nullable: true description: ACLED civilian_targeting label when available. EventFamily: type: string enum: - conflict - cameoplus Geo: type: object properties: country: type: string nullable: true region: type: string nullable: true continent: type: string nullable: true admin1: type: string nullable: true location: type: string nullable: true latitude: type: number nullable: true longitude: type: number nullable: true GeoContext: type: object description: >- Explains broad geography matches. geo is the event/story location; actor_origin_countries explains matches where the requested country, region, or continent came from actor origin instead. properties: location_country: type: string nullable: true actor_origin_countries: type: array items: type: string EntityRef: type: object properties: id: type: string name: type: string type: type: string nullable: true wikipedia_url: type: string format: uri nullable: true image_url: type: string format: uri nullable: true description: Best-effort Wikipedia thumbnail URL for UI rendering. avatar_url: type: string format: uri nullable: true description: Best-effort compact avatar URL, usually the same as image_url. Article: type: object properties: id: type: string nullable: true url: type: string format: uri title: type: string nullable: true domain: type: string nullable: true domain_avatar_url: type: string format: uri nullable: true description: Best-effort source-domain avatar/favicon URL for UI rendering. image_url: type: string format: uri nullable: true description: Best-effort source article sharing image from the GDELT GKG layer. article_date: type: string format: date nullable: true rank: type: integer nullable: true role: type: string nullable: true ErrorResponse: type: object properties: success: type: boolean enum: - false error: type: string code: type: string details: type: object description: >- Recoverable validation context when available, such as param, invalid_value, accepted_values, nearest_values, and a corrected example. additionalProperties: true responses: NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: gdelt_sk_... description: 'GDELT Cloud API key. Send as `Authorization: Bearer gdelt_sk_...`.' ````