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

import requests

url = "https://gdeltcloud.com/api/v2/gov/fara"

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

{
  "query": {
    "entity": null,
    "registrant": null,
    "foreign_principal": null,
    "country": null,
    "adversary_only": false,
    "sanctioned_only": true,
    "active_only": false,
    "limit": 25
  },
  "summary": {
    "links": 73,
    "registrants": 68,
    "foreign_principals": 57,
    "countries": 22,
    "adversary_links": 41,
    "sanctioned_links": 73,
    "active_links": 6
  },
  "links": [
    {
      "registration_number": "6560",
      "registrant_name": "Ruder Finn, Inc.",
      "registrant_entity_id": "e_1a2b3c4d5e6f7a8b",
      "foreign_principal": "Huawei Technologies Co., Ltd.",
      "foreign_principal_entity_id": "e_9f8e7d6c5b4a3f2e",
      "country": "CHINA",
      "country_adversary": 1,
      "fp_sanctioned": 1,
      "fp_sanction_lists": [
        "dod_1260h",
        "csl_bis_entity",
        "csl_ofac_cmic"
      ],
      "fp_sanction_programs": [
        "1260H",
        "CMIC-EO13959"
      ],
      "fp_registration_date": "2024-05-14",
      "fp_termination_date": "",
      "is_active": 1,
      "source_url": "https://efile.fara.gov/ords/fara/f?p=1381:200:::NO:RP,200:P200_REG_NUMBER:6560"
    }
  ],
  "meta": {
    "source": "gov.fara_foreign_principals",
    "attributions": [
      {
        "source": "DOJ NSD — FARA eFile (Foreign Agents Registration Act)",
        "source_url": "https://efile.fara.gov/",
        "license": "US Public Domain",
        "note": "Foreign Agents Registration Act filings are US public domain (Department of Justice). One row per (US registrant, foreign principal) link."
      }
    ]
  }
}

{
  "success": false,
  "error": "one of entity= (resolved entity_id), registrant= (fuzzy name), foreign_principal= (fuzzy name), country= (e.g. RUSSIA), adversary_only=true, or sanctioned_only=true is required.",
  "code": "MISSING_PARAM"
}

{
  "success": false,
  "error": "API key required. Include: Authorization: Bearer gdelt_sk_...",
  "code": "MISSING_API_KEY"
}

{
  "success": false,
  "error": "Government exposure (federal awards) is not included in your plan. Upgrade at https://gdeltcloud.com/pricing to unlock it.",
  "code": "PLAN_REQUIRED"
}

{
  "success": false,
  "error": "Rate limit or quota exceeded.",
  "code": "RATE_LIMITED"
}

{
  "success": false,
  "error": "Failed to fetch FARA links.",
  "code": "INTERNAL_ERROR"
}