---
title: "Federal Awards (USAspending)"
method: GET
path: "/api/v2/gov/awards"
tags: ["Government"]
---

# Federal Awards (USAspending)

`GET /api/v2/gov/awards`

US federal award exposure for an entity — USAspending prime awards (contracts + grants) resolved to the entity spine. Look a subject up three ways (at least one is required): a resolved spine `entity_id` (`entity=`), a SAM.gov Unique Entity Identifier (`uei=`), or a fuzzy recipient name (`recipient=`). Returns an aggregate `summary` (total obligated USD, award + recipient counts) with a per-UEI `recipient_rollups` breakdown (top 25 by obligated USD, each with its awarding agencies and first/last action dates), plus the recent `awards` timeline — every row cited to its USAspending permalink. **D&B carve-out:** keyed on the SAM.gov UEI only — Dun & Bradstreet's DUNS number and corporate-family (parent) tree are never ingested or surfaced. Plan-gated: requires the `can_use_gov` entitlement (Markets plan and up); non-entitled plans receive 403 PLAN_REQUIRED. Reads are bounded key-prefix lookups on the current award snapshot (no all-time scan).

## Query parameters

- `entity` string
- `uei` string
- `recipient` string
- `limit` integer

## Response `200`

Success

- GovAwardsResponse — Entity federal-award exposure — USAspending prime awards keyed on SAM.gov UEI, resolved to the entity spine.
  - `query` object
    - `entity` string, nullable
    - `uei` string, nullable
    - `recipient` string, nullable
    - `limit` integer
  - `summary` object
    - `recipients` integer — Distinct recipient UEIs across all matching awards.
    - `total_awards` integer — Total matching awards (not capped by limit).
    - `total_obligated` number — Sum of obligations across all matching awards, in USD.
    - `recipient_rollups` object[] — Per-UEI rollup, top 25 by obligated USD.
      - `recipient_uei` string
      - `recipient_name` string
      - `entity_id` string — Resolved spine entity id; empty string when the recipient did not resolve to the spine.
      - `award_count` integer
      - `total_obligated` number — Sum of award obligations for this UEI, in USD.
      - `agency_count` integer
      - `top_agencies` string[] — Up to 10 distinct awarding agencies for this UEI.
      - `first_action_date` string, date
      - `last_action_date` string, date
  - `awards` object[] — Recent award timeline (up to limit), newest first.
    - `award_id` string — USAspending award unique key (the permalink id).
    - `recipient_name` string
    - `recipient_uei` string
    - `entity_id` string — Resolved spine entity id; empty string when unresolved.
    - `award_amount` number — Obligated amount for this award, in USD.
    - `awarding_agency` string
    - `awarding_sub_agency` string
    - `award_group` string — contract | grant | loan | direct_payment | other.
    - `award_type` string
    - `action_date` string, date — Latest action date for the award.
    - `end_date` string — Period-of-performance end date; empty string when unknown.
    - `source_url` string — USAspending permalink for the award.
  - `meta` object
    - `source` string
    - `attributions` object[]
      - `source` string
      - `source_url` string
      - `license` string
      - `note` string
    - `note` string, nullable — Present only when the result set is empty.
  - `cross_source` GovCrossSource — Cross-source fusion for the primary resolved entity — its footprint beyond this endpoint (foreign-agent status, SEC filer, facilities owned) + headline flags. Null when there is no cross-source signal.
    - `entity_id` string
    - `federal_awards` object, nullable
      - `awards` integer
      - `total_obligated` number
    - `foreign_agent` object, nullable — This entity AS a US registrant (foreign agent).
      - `registrations` integer
      - `foreign_principals` integer
      - `sanctioned_principals` integer — Foreign principals it represents that are on a sanctions list.
      - `countries` string[]
    - `foreign_principal_of` object, nullable — This entity AS a foreign principal — the US firms registered to represent it.
      - `us_registrants` integer
    - `sec_filer` boolean
    - `facilities_owned` integer
    - `flags` string[] — Headline cross-flags: federal_contractor_and_foreign_agent, foreign_agent_for_sanctioned_entity.

## Other responses

- `400` — Missing subject (need entity / uei / recipient), or a bare name passed to entity=.
- `401` — API key required. Include: Authorization: Bearer gdelt_sk_...
- `403` — The caller's plan does not carry the can_use_gov entitlement (Markets plan and up).
- `429` — Rate limit or quota exceeded.
- `500` — Failed to fetch government exposure.

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/revisions/01aaa6255180/schema)