Twinkle HubTwinkle Hub
Sign in

📌 2026-08-17 added: ⚖️ Taiwan statute time machine — historical article text · revision history · full-text search · citation graph (935 datasets · 35,454+ rows)

View full changelog →

US federal award full record

us_get_award_details

TW-specificMIT

**關鍵字 / Keywords**: 美國聯邦標案 詳情 award detail contract grant loan period_of_performance subaward recipient UEI DUNS PSC NAICS place-of-performance executive-comp officer USASpending federal spending single award record

Scope: one US federal award's complete record.

Endpoint:
    GET https://api.usaspending.gov/api/v2/awards/{award_id}/

Args:
    award_id: pass the `generated_internal_id` returned by
              `us_search_awards`
              (e.g. `"CONT_AWD_N0001917C0001_9700_-NONE-_-NONE-"`).
              Do NOT pass the display "Award ID" (PIID / FAIN) —
              that shape isn't guaranteed to resolve.

Returns the full USASpending envelope including:
    recipient (name, UEI, DUNS, parent, location, business_categories)
    period_of_performance (start_date, end_date, potential_end_date)
    awarding_agency + funding_agency (toptier · subtier · office)
    naics_hierarchy · psc_hierarchy (industry / product classification)
    executive_details (top-5 officers + comp)
    place_of_performance (state · city · congressional district)
    total_obligation · total_outlay · subaward_count ·
    total_subaward_amount
    latest_transaction_contract_data (contract-only)

License: "Creative Commons Zero v1.0 Universal (CC0-1.0)".
Rate-limited to ~5 req/sec.

Input schema

{
  "properties": {
    "award_id": {
      "title": "Award Id",
      "type": "string"
    }
  },
  "required": [
    "award_id"
  ],
  "title": "us_get_award_detailsArguments",
  "type": "object"
}

How to call

Once your Twinkle Hub MCP client is configured, your agent will see us_get_award_details. Just ask it to call — example:

# Ask Claude / any MCP client:
請用 us_get_award_details 處理 "…"。

# It will call:
us_get_award_details(input="…")

Haven't set up a client yet?

Claude Desktop in 3 minutes — download the .mcpb and double-click, or see docs for other clients.

See user docs