curl --request GET \
  --url https://gdeltcloud.com/api/v2/monitors/{id}/runs \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://gdeltcloud.com/api/v2/monitors/{id}/runs"

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/monitors/{id}/runs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "monitor": {
    "id": "5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
    "organization_id": "88949d2a-4f00-45cb-9d23-2d242ddfe74d",
    "created_by": "c6951b53-952b-40bf-99fd-c9d97a176f38",
    "name": "Port disruption watch",
    "description": "New coverage of port closures and shipping disruption in the United States.",
    "enabled": true,
    "subject": {
      "type": "topic"
    },
    "criteria": {
      "data": "events_and_stories",
      "search": "port closure shipping disruption",
      "countries": [
        "USA"
      ],
      "family_filters": {
        "cameoplus": {
          "domains": [
            "INFRASTRUCTURE"
          ],
          "subcategories": []
        },
        "story": {
          "categories": [
            "cameoplus_infrastructure"
          ]
        }
      },
      "fatalities_only": false
    },
    "trigger": {
      "type": "new_matches"
    },
    "schedule": {
      "cadence": "hourly",
      "timezone": "UTC",
      "daily_hour": 8
    },
    "delivery": {
      "email": true,
      "webhook": {
        "configured": true,
        "endpoint": "https://example.com/gdelt-webhook",
        "consecutive_failures": 0,
        "last_success_at": "2026-08-23T14:05:00.000Z",
        "last_failure_at": null
      }
    },
    "created_at": "2026-08-23T13:00:00.000Z",
    "updated_at": "2026-08-23T14:05:00.000Z",
    "last_checked_at": "2026-08-23T14:00:00.000Z",
    "last_triggered_at": "2026-08-23T14:00:00.000Z",
    "legacy": false
  },
  "runs": [
    {
      "id": "6d403a03-83a7-4603-a92d-37012fbf0219",
      "execution_key": "monitor/5e1d3b89-9c34-4fa1-80fc-17f72f782b33/v1/2026-08-24T14:00:00.000Z",
      "alert_rule_id": "5e1d3b89-9c34-4fa1-80fc-17f72f782b33",
      "alert_log_id": 412,
      "shared_run_id": "7b1a1fac-f9dc-4667-b013-3de5ed4bf6fa",
      "results": [
        {
          "item_id": "story:story_example",
          "lane": "story",
          "id": "story_example",
          "title": "Port operations paused after labor disruption"
        }
      ],
      "result_count": 3,
      "summary_json": {
        "total_matches": 3,
        "total_matches_is_lower_bound": false,
        "candidate_limit": 100,
        "retained_matches": 1,
        "truncated": true,
        "disposition": "triggered",
        "reason": "3 new matches found in the current window.",
        "frequency": "hourly",
        "target_family": "cameoplus",
        "selected_families": [
          "cameoplus",
          "conflict",
          "story"
        ],
        "window_start": "2026-08-24T13:00:00.000Z",
        "window_end": "2026-08-24T14:00:00.000Z",
        "window_label": "Previous completed UTC hour",
        "family_groups": [
          {
            "label": "Story",
            "count": 1
          }
        ],
        "country_groups": [
          {
            "label": "United States",
            "count": 1
          }
        ],
        "signal_groups": [],
        "top_items": [
          {
            "title": "Port operations paused after labor disruption",
            "family": "story",
            "meta": "United States",
            "observed_at": "2026-08-24T13:42:00.000Z"
          }
        ]
      },
      "ai_summary": null,
      "retained_row_count": 1,
      "truncated": true,
      "evaluation_json": {
        "would_trigger": true,
        "disposition": "triggered",
        "reason": "3 new matches found in the current window.",
        "current_count": 3,
        "baseline_average": null,
        "event_count": null,
        "story_count": null,
        "event_baseline_average": null,
        "story_baseline_average": null,
        "new_item_ids": [
          "story:story_example"
        ],
        "trigger_fingerprint": "sha256:opaque"
      },
      "executed_at": "2026-08-24T14:00:04.000Z",
      "viewed_at": null,
      "expires_at": "2026-08-31T14:00:04.000Z",
      "created_at": "2026-08-24T14:00:04.000Z"
    }
  ],
  "total": 1,
  "limit": 25,
  "offset": 0
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}

{
  "success": false,
  "error": "<string>",
  "code": "<string>",
  "details": {}
}