Skip to main content
GET
/
api
/
v2
/
briefs
/
{id}
cURL
curl "https://gdeltcloud.com/api/v2/briefs/$BRIEF_ID" \
  -H "Authorization: Bearer $GDELT_CLOUD_API_KEY"
{
  "id": "brief_123",
  "status": "ready",
  "title": "Red Sea maritime disruption watch",
  "brief_type": "monitoring_brief",
  "created_at": "2026-06-08T14:00:00Z",
  "updated_at": "2026-06-08T14:08:00Z",
  "error_message": null,
  "input": {
    "time_window": "7d",
    "audience": "executive"
  },
  "document": {
    "bottom_line": "Disruption risk remains elevated."
  },
  "citations": [],
  "appendix": [],
  "public_url": null,
  "web_url": "https://gdeltcloud.com/briefs/brief_123"
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Brief id from create or list.

Response

The Brief.

id
string
title
string
brief_type
string
status
string

queued → generating → building → ready, or failed.

created_at
string
updated_at
string
error_message
string | null
input
object
document
object

Structured Monitoring Brief content.

citations
object[]
appendix
object

Evidence chain / tool-call ledger.

public_url
string | null
web_url
string