curl --request GET \
  --url http://localhost:4000/v2/events-monitor/event-groups \
  --header 'x-api-key: <api-key>'

import requests

url = "http://localhost:4000/v2/events-monitor/event-groups"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('http://localhost:4000/v2/events-monitor/event-groups', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "4000",
  CURLOPT_URL => "http://localhost:4000/v2/events-monitor/event-groups",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:4000/v2/events-monitor/event-groups"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("http://localhost:4000/v2/events-monitor/event-groups")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost:4000/v2/events-monitor/event-groups")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "meta": {
    "totalItems": 123,
    "totalPages": 13,
    "currentPage": 1,
    "pageSize": 10,
    "unfilteredTotalItems": 196,
    "unfilteredTotalPages": 20
  },
  "data": [
    [
      {
        "_id": "69e5bfcd21aab5bcbb62eae4",
        "title": "China Sees Greater Integration Between Trade and Investment, Creating New Opportunities",
        "summary": "China's foreign trade sector is increasingly integrating trade and investment functions, a trend noted by state broadcaster coverage highlighting evolving policy and market structures. This integration can foster deeper value-chain links, encourage inward and outbound investment tied to trade flows, and create procurement opportunities for multinational firms seeking integrated supply-and-investment strategies. For trading companies and investors, integrated approaches can streamline cross-border operations, facilitate production localization and affect supplier selection and partnership models. The narrative indicates potential opportunities for firms to leverage investment to secure market access, though the story does not provide quantitative data or named project examples.",
        "vectorIndex": {
          "anchorText": "a government narrative promoting closer alignment of trade and investment to spur commercial opportunities",
          "embeddings": [
            123
          ],
          "embeddingsModelName": "<string>"
        },
        "lastUpdated": "2026-04-20T05:38:42.448Z",
        "eventSearchKeywords": [
          {
            "keyword": "China foreign trade",
            "propertySource": "inferred"
          },
          {
            "keyword": "investment",
            "propertySource": "inferred"
          },
          {
            "keyword": "trade-investment integration",
            "propertySource": "inferred"
          },
          {
            "keyword": "supply chain",
            "propertySource": "inferred"
          },
          {
            "keyword": "market access",
            "propertySource": "inferred"
          }
        ],
        "relevantEntities": [
          {
            "name": "Trade and Investment Integration",
            "entityType": "category",
            "propertySource": "inferred"
          },
          {
            "name": "Supply Chain Localization",
            "entityType": "category",
            "propertySource": "inferred"
          },
          {
            "name": "China",
            "entityType": "country",
            "propertySource": "inferred"
          }
        ],
        "timestamps": {
          "published": "2026-04-20T05:38:41.505Z",
          "recordedStart": "2026-04-19T14:03:00.073Z"
        },
        "references": [
          {
            "_id": "69e5b8d17a3ce8b7e8505aa5",
            "title": "China’s foreign trade, investment integration generates greater opportunities",
            "url": "https://www.globaltimes.cn/page/202604/1359275.shtml"
          }
        ],
        "providers": [
          "public_news_search"
        ],
        "taxonomicMatches": {
          "affectedDatapoints": [
            {
              "name": "Net Supply",
              "subject": null,
              "direction": "down",
              "quantity": null
            },
            {
              "name": "Unit Price",
              "subject": "crude oil",
              "direction": "up",
              "quantity": {
                "operator": ">",
                "values": [
                  10
                ],
                "unit": "%"
              }
            }
          ],
          "alertTypes": [
            {
              "name": "Geopolitical and Trade",
              "mappedFrom": "geopolitical risk",
              "method": "llm",
              "similarity": 1,
              "rationale": "The candidate covers geopolitical risks affecting trade and diplomatic relations."
            },
            {
              "name": "Logistics and Supply Chain",
              "mappedFrom": "supply chain dependency",
              "method": "llm",
              "similarity": 1,
              "rationale": "Directly refers to supply chain logistics and dependencies"
            }
          ],
          "impactedEntities": [
            {
              "name": "Trade Finance Services",
              "entityType": "category",
              "mappedFrom": "trade and investment integration: Strategies that coordinate cross-border trade flows with inward or outward investment decisions.",
              "impact": {
                "likelihood": 2,
                "severity": 1,
                "rationale": "Policy emphasis may encourage firms to pursue combined trade/investment approaches, creating commercial opportunities."
              }
            },
            {
              "name": "Investment Management",
              "entityType": "category",
              "mappedFrom": "trade and investment integration: Strategies that coordinate cross-border trade flows with inward or outward investment decisions.",
              "impact": {
                "likelihood": 2,
                "severity": 1,
                "rationale": "Policy emphasis may encourage firms to pursue combined trade/investment approaches, creating commercial opportunities."
              }
            },
            {
              "name": "Strategy Consulting",
              "entityType": "category",
              "mappedFrom": "trade and investment integration: Strategies that coordinate cross-border trade flows with inward or outward investment decisions.",
              "impact": {
                "likelihood": 2,
                "severity": 1,
                "rationale": "Policy emphasis may encourage firms to pursue combined trade/investment approaches, creating commercial opportunities."
              }
            }
          ]
        }
      }
    ]
  ]
}

{
  "success": false,
  "errorCode": "QUERY_VALIDATION_FAILED",
  "message": "Invalid query parameters"
}

{
  "success": false,
  "errorCode": "UNAUTHORISED",
  "message": "Unauthorized access - API Key is missing or invalid"
}

{
  "success": false,
  "errorCode": "FORBIDDEN",
  "message": "API Key not subscribed to this endpoint"
}

{
  "success": false,
  "errorCode": "INTERNAL_SERVER_ERROR",
  "message": "Internal Server Error"
}