# USAspending API: Search federal awards > Searches USAspending federal awards by keywords, awarding agency, state of performance and date across contracts, grants, loans and direct payments. Searches from October 1, 2007 onward. Unofficial. Not affiliated with or endorsed by USAspending. - Page: https://fous.com/methods/usaspending.gov/search-federal-awards - Method: `usaspending.gov/search_federal_awards`, version 1 - Website: usaspending.gov - Returns: recipient, amount, agency, description, award type, dates, place of performance, award link, award ID, recipient UEI - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | | Order by largest amount or newest award, for example newest. One of "largest_amount", "newest". Default "largest_amount". | | `state` | string | no | | State where the work is performed, for example California or CA. | | `agency` | string | no | | Awarding agency name, for example Department of Energy. | | `end_date` | string | no | | Last date to search in YYYY-MM-DD, for example 2026-09-29. Defaults to today. | | `keywords` | string | yes | `"wildfire"` | Topic to search for, for example wildfire prevention. | | `award_type` | string | no | `"contracts"` | Award kinds to include, for example grants. One of "all", "contracts", "grants", "loans", "direct_payments". Default "all". | | `start_date` | string | no | | First date to search in YYYY-MM-DD, for example 2025-10-01. Defaults to 12 months before end date. | | `max_results` | integer | no | `100` | Maximum awards to return, for example 25. Default 25. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "keywords": "wildfire", "award_type": "contracts", "max_results": 100 } ``` Its output: ```json { "awards": [ { "amount": 735420508.05, "award_id": "W912PL25F0041", "end_date": "2026-01-07", "award_link": "https://www.usaspending.gov/award/CONT_AWD_W912PL25F0041_9700_W912EK23D0011_9700", "award_type": "DELIVERY ORDER", "start_date": "2025-02-10", "description": "CALIFORNIA WILDFIRES 2025 PPDR EATON. ISSUED BY USACE IN SUPPORT OF FEMA PER THE STAFFORD ACT.", "currency_code": "USD", "recipient_uei": "LJPLMV3GCYE7", "recipient_name": "ECC CONSTRUCTORS LLC", "awarding_agency": "Department of Defense", "place_of_performance_city": "ALTADENA", "place_of_performance_state": "California" }, { "amount": 614335065.02, "award_id": "W912PL25F0042", "end_date": "2026-01-07", "award_link": "https://www.usaspending.gov/award/CONT_AWD_W912PL25F0042_9700_W912EK23D0011_9700", "award_type": "DELIVERY ORDER", "start_date": "2025-02-10", "description": "CALIFORNIA WILDFIRES 2025 PPDR PACIFIC PALISADES. ISSUED BY USACE IN SUPPORT OF FEMA PER THE STAFFORD ACT.", "currency_code": "USD", "recipient_uei": "LJPLMV3GCYE7", "recipient_name": "ECC CONSTRUCTORS LLC", "awarding_agency": "Department of Defense", "place_of_performance_city": "PACIFIC PALISADES", "place_of_performance_state": "California" }, { "amount": 373314199.4, "award_id": "W9128A24F0011", "end_date": "2026-02-25", "award_link": "https://www.usaspending.gov/award/CONT_AWD_W9128A24F0011_9700_W912EK22D0004_9700", "award_type": "DELIVERY ORDER", "start_date": "2024-01-05", "description": "DEBRIS REMOVAL & DISPOSAL OPERATIONS FOR 268 PROPERTIES IN LAHAINA, HI DUE TO THE HAWAII WILDFIRE IN AUGUST 2023.", "currency_code": "USD", "recipient_uei": "LJPLMV3GCYE7", "recipient_name": "ECC CONSTRUCTORS LLC", "awarding_agency": "Department of Defense", "place_of_performance_city": "LAHAINA", "place_of_performance_state": "Hawaii" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"usaspending.gov/search_federal_awards","input":{"keywords":"wildfire","award_type":"contracts","max_results":100}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find the largest federal grants awarded for wildfire prevention in California since 2022, showing recipient, amount and place of performance. - Show me the newest contracts the Department of Energy awarded for battery storage research in 2025. - List federal loans and direct payments tied to rural broadband in Montana between 2019 and 2024, sorted by amount. - On usaspending.gov, pull up awards for water infrastructure in Texas from October 2023 through September 2025, limited to 50 results. - Which recipients got the biggest federal awards for veteran housing programs in Ohio over the past year? I need recipient UEI and award IDs. ## Input schema ```json { "type": "object", "required": [ "keywords" ], "properties": { "sort": { "enum": [ "largest_amount", "newest" ], "type": "string", "default": "largest_amount", "description": "Order by largest amount or newest award, for example newest." }, "state": { "type": "string", "description": "State where the work is performed, for example California or CA." }, "agency": { "type": "string", "description": "Awarding agency name, for example Department of Energy." }, "end_date": { "type": "string", "description": "Last date to search in YYYY-MM-DD, for example 2026-09-29. Defaults to today." }, "keywords": { "type": "string", "minLength": 1, "description": "Topic to search for, for example wildfire prevention." }, "award_type": { "enum": [ "all", "contracts", "grants", "loans", "direct_payments" ], "type": "string", "default": "all", "description": "Award kinds to include, for example grants." }, "start_date": { "type": "string", "description": "First date to search in YYYY-MM-DD, for example 2025-10-01. Defaults to 12 months before end date." }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum awards to return, for example 25." } } } ``` ## Output schema ```json { "type": "object", "required": [ "awards" ], "properties": { "awards": { "type": "array", "items": { "type": "object", "required": [ "recipient_name", "amount", "currency_code", "awarding_agency", "description", "award_type", "start_date", "end_date", "place_of_performance_city", "place_of_performance_state", "award_link", "award_id", "recipient_uei" ], "properties": { "amount": { "type": [ "number", "null" ] }, "award_id": { "type": [ "string", "null" ], "x-fous-developer": true }, "end_date": { "type": [ "string", "null" ], "format": "date" }, "award_link": { "type": [ "string", "null" ] }, "award_type": { "type": [ "string", "null" ] }, "start_date": { "type": [ "string", "null" ], "format": "date" }, "description": { "type": [ "string", "null" ] }, "currency_code": { "type": "string" }, "recipient_uei": { "type": [ "string", "null" ], "x-fous-developer": true }, "recipient_name": { "type": [ "string", "null" ] }, "awarding_agency": { "type": [ "string", "null" ] }, "place_of_performance_city": { "type": [ "string", "null" ] }, "place_of_performance_state": { "type": [ "string", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [USAspending API: Get company federal awards](https://fous.com/methods/usaspending.gov/get-company-federal-awards.md): Returns federal obligations and distinct awards for a company or organization, including its parent and child recipient records. Covers the selected fiscal year or the last five fiscal years. - [USAspending API: Get agency spending](https://fous.com/methods/usaspending.gov/get-agency-spending.md): Gets a federal agency's fiscal-year budgetary resources, obligations, share of federal obligations, new award count, top recipients and spending classes from USAspending. - [Grants.gov API: Search grant opportunities](https://fous.com/methods/grants.gov/search-grants.md): Finds U.S. federal grant opportunities by topic, agency, applicant type and status, with funding and eligibility details. Open results exclude opportunities whose closing date has passed. - [SAM.gov API: Search contract opportunities](https://fous.com/methods/sam.gov/search-contract-opportunities.md): Finds active federal contract notices on SAM.gov that match keywords, agency, place of performance, set-aside, notice type and posting period. - [NIH API: Search grants](https://fous.com/methods/reporter.nih.gov/search-grants.md): Finds NIH research grants by topic, organisation, or researcher name. Searches the last five fiscal years by default. - [USAJOBS API: Search federal jobs](https://fous.com/methods/usajobs.gov/search-jobs.md): Searches USAJOBS federal jobs by keywords, location, salary threshold and applicant group, in website relevance order. Salary ranges may start below the threshold; annual pay or remote status is null when the announcement does not state it. - [European Union API: Search EU contract awards](https://fous.com/methods/ted.europa.eu/search-contract-awards.md): Finds published EU contract award notices on Tenders Electronic Daily by contract topic or winning company, newest publication first, optionally limited to a buyer country and a start date. Values and tender counts are included when published; counts across lots are summed. - [Federal Register API: Search rules and notices](https://fous.com/methods/federalregister.gov/search-rules.md): Find Federal Register rules, proposed rules, notices, and presidential documents by topic, agency, publication dates, and comment status. Significant means designated significant by the source; documents without that designation show no. - [All USAspending methods](https://fous.com/methods/usaspending.gov.md)