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

import requests

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

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

{
  "query": {
    "entity": null,
    "uei": null,
    "recipient": "Lockheed",
    "limit": 25
  },
  "summary": {
    "recipients": 34,
    "total_awards": 4821,
    "total_obligated": 342118904233,
    "recipient_rollups": [
      {
        "recipient_uei": "K8YHEXAMPLE01",
        "recipient_name": "LOCKHEED MARTIN CORPORATION",
        "entity_id": "e_7e9bc31057830fbf",
        "award_count": 3120,
        "total_obligated": 301884221190,
        "agency_count": 12,
        "top_agencies": [
          "Department of Defense",
          "National Aeronautics and Space Administration",
          "Department of State"
        ],
        "first_action_date": "1998-03-11",
        "last_action_date": "2026-06-28"
      }
    ]
  },
  "awards": [
    {
      "award_id": "CONT_AWD_FA860124C0001_9700",
      "recipient_name": "LOCKHEED MARTIN CORPORATION",
      "recipient_uei": "K8YHEXAMPLE01",
      "entity_id": "e_7e9bc31057830fbf",
      "award_amount": 1200000000,
      "awarding_agency": "Department of Defense",
      "awarding_sub_agency": "Department of the Air Force",
      "award_group": "contract",
      "award_type": "DEFINITIVE CONTRACT",
      "action_date": "2026-06-28",
      "end_date": "2031-06-27",
      "source_url": "https://www.usaspending.gov/award/CONT_AWD_FA860124C0001_9700"
    }
  ],
  "meta": {
    "source": "gov.usaspending_awards",
    "attributions": [
      {
        "source": "USAspending.gov",
        "source_url": "https://www.usaspending.gov/",
        "license": "US Public Domain",
        "note": "Federal award data is US public domain. Keyed on SAM.gov UEI; Dun & Bradstreet fields (DUNS, corporate-family tree) are excluded by license."
      }
    ]
  }
}

{
  "success": false,
  "error": "gov \"entity\"/\"entity_id\" must be a resolved entity id (e.g. e_… or wiki:…). \"Lockheed\" looks like a name — resolve it via GET /api/v2/search?q=Lockheed and pass its entity_id, or use recipient= for a fuzzy recipient-name match, or uei= for a SAM.gov UEI.",
  "code": "INVALID_ENTITY_ID"
}

{
  "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 government exposure.",
  "code": "INTERNAL_ERROR"
}