Federal Awards — cited contract spending

Federal contract-award dollars for a U.S. fiscal year, ranked by awarding agency, by place-of-performance state, or by recipient, returned with a full citation receipt. Built for AI agents and analysts who need a spending number they can defend, with the exact public source attached.

Data comes straight from USASpending.gov — the primary, public-domain federal record of contract awards. No aggregator, no scoring, no editorializing.

What you can ask

• Which agencies obligated the most contract dollars in fiscal year 2024?
• Which states received the most federal award spending by place of performance?
• Which recipients (companies, universities, nonprofits — identified by their federal UEI) were awarded the most?

Keywords: federal spending, government contracts, USAspending, contract awards, procurement, agency budgets, government contractors, award recipients, UEI, federal grants and contracts, public spending, defense spending, GovCon.

Input

Field	Type	Required	Notes
fiscal_year	integer	yes	U.S. fiscal year, e.g. 2024.
group_by	"agency" | "state" | "recipient"	no (default agency)	How to rank.
limit	integer 1–500	no (default 50)	Max ranked rows.

{ "fiscal_year": 2024, "group_by": "agency", "limit": 5 }

Output — an answer with a receipt

The actor returns one receipt object (also stored as the run's OUTPUT). The answer is the ranked totals; matches declares any cross-source join the answer relied on, and citations is the exact source you can re-run yourself.

{
  "answer": [
    {
      "fiscal_year": 2024,
      "agency_entity_id": "agcy_5f3b…",
      "agency_name": "Department of Defense",
      "total_cents": 41880000000000,
      "award_count": 128342
    }
  ],
  "citations": [
    {
      "source": "usaspending",
      "source_label": "USAspending.gov",
      "query_url": "https://api.usaspending.gov/api/v2/search/spending_by_award/?page=1",
      "retrieved_at": "2026-01-02T00:00:00.000Z",
      "as_of": null,
      "cache": "cached",
      "record_id": null
    }
  ],
  "coverage": [
    "Coverage reflects records currently in citature's dataset, not the full upstream history.",
    "An award's fiscal year is derived from its action/start date."
  ],
  "guardrails": [
    "Research over public-domain federal records — not legal, financial, or eligibility advice.",
    "citature reports what the record says. It never renders a compliance verdict, a screening pass/fail, or a recommendation.",
    "Entity-level records only (committees, candidates, recipients, agencies, contracts). No individual-person data."
  ],
  "matches": [
    {
      "match_method": "exact",
      "match_confidence": 1,
      "left_key": "usaspending.awarding_agency",
      "right_key": "citature.entity_agency.agency_name",
      "note": "agency resolved to a citature entity on the toptier awarding-agency name"
    }
  ],
  "schema_version": "0.1.0"
}

Money is always integer cents (total_cents). Ranking by recipient joins on the UEI, the universal federal awardee key; ranking by state uses a native award field and declares no join.

Guardrails

• Research over public-domain federal records — not legal, financial, or eligibility advice.
• citature reports what the record says. It never renders a compliance verdict, a screening pass/fail, or a recommendation.
• Entity-level records only. No individual-person data is ever returned.

Pricing

Pay per successful answer. You are charged only when an answer is served; a rejected or failed request is never billed.