{"uid":"cap_axOnrL2se_trtF5qGnofl","slug":"2s-io-eb1d9c87","name":"USAspending Federal Awards Search","description":"Search federal awards (contracts, grants, loans, direct payments) from USAspending.gov. Largest amount first within the date window. Each record includes award ID, recipient name, dollar amount, award type, awarding agency + sub-agency, start + end dates, description, and a permalink to the usaspending.gov detail page. Filter by recipient name, awarding agency name, recipient state, award type group, and date range. Backed by USAspending.gov's spending_by_award API; public-domain US government records.","url":"https://2s.io/api/gov/usaspending-awards","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","properties":{"page":{"type":"integer","default":1,"maximum":1000,"minimum":1,"description":"Page number (1-based). Default 1."},"limit":{"type":"integer","default":25,"maximum":100,"minimum":1,"description":"Records per page (1-100). Default 25."},"since":{"type":"string","description":"Earliest action date (YYYY-MM-DD). Default = 5 years ago."},"until":{"type":"string","description":"Latest action date (YYYY-MM-DD). Default = today."},"agency":{"type":"string","maxLength":120,"minLength":2,"description":"Awarding top-tier agency name. Examples: \"Department of Defense\", \"National Institutes of Health\", \"Department of Energy\"."},"awardType":{"enum":["contracts","grants","loans","direct_payments","other"],"type":"string","default":"contracts","description":"Award type group. contracts = A/B/C/D; grants = 02/03/04/05; loans = 07/08; direct_payments = 06/10; other = 11. Default contracts."},"recipient":{"type":"string","maxLength":120,"minLength":2,"description":"Recipient (vendor/grantee) name substring. Examples: \"Microsoft\", \"Lockheed Martin\", \"Stanford University\"."},"recipientState":{"type":"string","maxLength":2,"minLength":2,"description":"2-letter US state of the recipient (e.g., \"CA\", \"VA\")."}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"page":1,"limit":25,"agency":"Department of Defense","awardType":"contracts","recipientState":"VA"}}},"response":{"_truncated":true,"_originalSize":12580}},"exampleRequest":{"page":1,"limit":25,"agency":"Department of Defense","awardType":"contracts","recipientState":"VA"},"tags":["x402"],"displayCostAmount":"0.0024","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TS8xux0WBAidb7Cp_8R7P","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and filter US federal awards (contracts, grants, loans, direct payments) from USAspending.gov, returning records sorted by dollar amount descending.","exampleAgentPrompt":"Show me the largest Department of Defense contracts awarded to Lockheed Martin in Virginia between 2023-01-01 and 2024-12-31 — I want the top 25 results.","exampleUseCases":null,"resultDescription":"A paginated list of federal award records sorted by dollar amount descending. Each record includes: award ID, recipient name, dollar amount, award type, awarding agency and sub-agency, start and end dates, description of the award, and a permalink to the USAspending.gov detail page.","failureModes":["No records found for the given filters — returns empty results list","Invalid date format (not YYYY-MM-DD) — schema validation error","Invalid recipientState (not 2-letter code) — schema validation error","Invalid awardType enum value — schema validation error","Upstream USAspending.gov API unavailable — service error","Page number exceeds maximum of 1000 — validation error","Payment not processed — 402 payment required error"],"whenToPreferThis":"Use this endpoint when you need to search, filter, or analyze US federal government spending data across contracts, grants, loans, and direct payments. It is ideal for researching which companies or universities receive federal funding, tracking agency spending patterns, or looking up specific award details. Prefer this over general web search when you need structured, authoritative, public-domain federal spending data sorted by dollar amount.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:14.670Z","isFirstParty":false}