curl --request GET \
  --url https://gdeltcloud.com/api/v2/screening/match \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://gdeltcloud.com/api/v2/screening/match"

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/screening/match', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "query": {
    "q": "Hikvision",
    "id": null,
    "as_of": "2026-06-29",
    "threshold": 0.85
  },
  "disclaimer": "Risk-intelligence signal derived from public restricted-party lists and proprietary exposure data, as of the date shown. Not a sanctions-compliance determination or a substitute for due diligence.",
  "coverage": "Public restricted-party lists ingested into ref.list_entries (institution-only).",
  "match_count": 1,
  "matches": [
    {
      "entity_id": "e_7c2a4f1b8e9d3056",
      "name": "Hangzhou Hikvision Digital Technology Co., Ltd.",
      "score": 0.972,
      "confidence": "strong",
      "method": "fuzzy_name",
      "lists": [
        {
          "source_key": "dod_1260h",
          "entry_uid": "1260h-2026-041",
          "name": "Hikvision Digital Technology Co., Ltd.",
          "entity_kind": "entity",
          "country_iso3": "CHN",
          "programs": [
            "Section 1260H"
          ],
          "legal_basis": "Section 1260H, NDAA FY2021",
          "source_url": "https://www.defense.gov/News/Releases/",
          "ids": {
            "ticker": "002415.SZ"
          },
          "first_seen_date": "2022-10-05",
          "last_seen_date": "2026-06-29",
          "match_score": 0.972
        },
        {
          "source_key": "fcc_covered",
          "entry_uid": "fcc-2021-007",
          "name": "Hikvision Digital Technology Co., Ltd.",
          "entity_kind": "entity",
          "country_iso3": "CHN",
          "programs": [
            "FCC Covered List"
          ],
          "legal_basis": "Secure and Trusted Communications Networks Act of 2019",
          "source_url": "https://www.fcc.gov/supplychain/coveredlist",
          "ids": {},
          "first_seen_date": "2021-03-12",
          "last_seen_date": "2026-06-29",
          "match_score": 0.948
        }
      ],
      "exposure": {
        "lenses": [
          "china",
          "state_owned"
        ],
        "direct": true,
        "lists": [
          "dod_1260h",
          "fcc_covered"
        ],
        "china_edges": [
          "list_1260h",
          "gem_parent"
        ]
      }
    }
  ]
}

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

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

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