aid: usaspending url: https://raw.githubusercontent.com/api-evangelist/usaspending/refs/heads/main/apis.yml name: USAspending.gov kind: government description: USAspending.gov is the official open data source of federal spending information operated by the U.S. Department of the Treasury's Bureau of the Fiscal Service, implementing the DATA Act's transparency mandate. The underlying USAspending API (api.usaspending.gov) is a free, public, unauthenticated REST API that exposes federal contracts, grants, loans, direct payments, and other financial assistance awards, along with agency budgets, federal account and Treasury Account Symbol data, recipient profiles, and COVID-19 / disaster emergency relief spending. Most search and listing endpoints accept a POST with a JSON filter object rather than query parameters, given the complexity of the filter combinations; simpler lookup endpoints use GET with path parameters. The API and the usaspending-api server are open source. image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg tags: - Government - Federal Spending - Open Data - Contracts - Grants - DATA Act - Transparency - Public Sector created: '2026-07-03' modified: '2026-07-03' specificationVersion: '0.19' apis: - aid: usaspending:usaspending-awards-search-api name: USAspending Awards Search API tags: - Awards - Search - Contracts - Grants image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.usaspending.gov/docs/endpoints baseURL: https://api.usaspending.gov/api/v2 properties: - url: https://api.usaspending.gov/docs/endpoints type: Documentation - url: https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/search/spending_by_award.md type: APIReference - url: openapi/usaspending-openapi.yml type: OpenAPI description: Advanced search across federal award spending (contracts, IDVs, grants, loans, direct payments, other financial assistance). Accepts a complex JSON filter object (award type, agency, recipient, time period, place of performance, NAICS/PSC, keyword, and more) plus a requested field list, and returns paged, sortable award or subaward records. Powers the USAspending.gov Advanced Search page, spending-by-category, spending-by- geography, and spending-over-time breakdowns. - aid: usaspending:usaspending-agency-api name: USAspending Agency API tags: - Agency - Budget - Federal Government image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.usaspending.gov/docs/endpoints baseURL: https://api.usaspending.gov/api/v2 properties: - url: https://api.usaspending.gov/docs/endpoints type: Documentation - url: https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/agency/toptier_code.md type: APIReference - url: openapi/usaspending-openapi.yml type: OpenAPI description: Per-agency profile data keyed by toptier agency code - mission, website, budgetary resources, obligated and outlay amounts, awards, sub-agencies, and Disaster Emergency Fund Code (DEFC) participation for a given fiscal year. Powers the USAspending.gov agency profile pages. - aid: usaspending:usaspending-recipient-api name: USAspending Recipient API tags: - Recipient - Awardee - UEI - DUNS image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.usaspending.gov/docs/endpoints baseURL: https://api.usaspending.gov/api/v2 properties: - url: https://api.usaspending.gov/docs/endpoints type: Documentation - url: https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/recipient.md type: APIReference - url: openapi/usaspending-openapi.yml type: OpenAPI description: Recipient (awardee) profile data - list and search recipients by keyword, UEI, or (deprecated) DUNS, sorted by award amount, plus per- recipient award breakdowns by award type and state. Powers the USAspending.gov recipient profile pages. - aid: usaspending:usaspending-federal-account-api name: USAspending Federal Account API tags: - Federal Account - Treasury Account Symbol - Appropriations image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.usaspending.gov/docs/endpoints baseURL: https://api.usaspending.gov/api/v2 properties: - url: https://api.usaspending.gov/docs/endpoints type: Documentation - url: https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/federal_accounts/account_number.md type: APIReference - url: openapi/usaspending-openapi.yml type: OpenAPI description: Federal account and child Treasury Account Symbol (TAS) data for a given fiscal year - account title, parent agency and bureau, and aggregated obligated, gross outlay, and budgetary resources amounts. Powers the USAspending.gov federal account landing and detail pages. - aid: usaspending:usaspending-budget-function-api name: USAspending Budget Function API tags: - Budget Function - Budget Subfunction - Federal Budget image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.usaspending.gov/docs/endpoints baseURL: https://api.usaspending.gov/api/v2 properties: - url: https://api.usaspending.gov/docs/endpoints type: Documentation - url: https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/budget_functions/list_budget_functions.md type: APIReference - url: openapi/usaspending-openapi.yml type: OpenAPI description: Reference listings of the federal budget's functional classification - budget functions and budget subfunctions (for example, National Defense, Health, Income Security) used to categorize and filter agency budgetary resources across the federal government. - aid: usaspending:usaspending-disaster-emergency-funding-api name: USAspending Disaster/Emergency Funding (COVID-19) API tags: - Disaster - Emergency Funding - COVID-19 - DEFC image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.usaspending.gov/docs/endpoints baseURL: https://api.usaspending.gov/api/v2 properties: - url: https://api.usaspending.gov/docs/endpoints type: Documentation - url: https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/disaster/overview.md type: APIReference - url: openapi/usaspending-openapi.yml type: OpenAPI description: Funding and spending detail for emergency and disaster supplemental appropriations, tracked by Disaster Emergency Fund Code (DEFC) - including the CARES Act and other COVID-19 relief legislation. Breaks down total budget authority, obligations, and outlays by agency, award, CFDA program, federal account, object class, recipient, and geography. - aid: usaspending:usaspending-bulk-download-api name: USAspending Bulk Download API tags: - Bulk Download - CSV - Data Export image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.usaspending.gov/docs/endpoints baseURL: https://api.usaspending.gov/api/v2 properties: - url: https://api.usaspending.gov/docs/endpoints type: Documentation - url: https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/bulk_download/awards.md type: APIReference - url: openapi/usaspending-openapi.yml type: OpenAPI description: Asynchronous bulk export of filtered award, account, and transaction data as zipped CSV, TSV, or pipe-delimited text files. A request kicks off zip-file generation on the backend; a companion status endpoint is polled until the file is ready for download. Also lists agencies and monthly generated files available for download. Powers the USAspending.gov Custom Award Data Download page. - aid: usaspending:usaspending-references-autocomplete-api name: USAspending References & Autocomplete API tags: - References - Autocomplete - Agencies - NAICS - CFDA image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.usaspending.gov/docs/endpoints baseURL: https://api.usaspending.gov/api/v2 properties: - url: https://api.usaspending.gov/docs/endpoints type: Documentation - url: https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/references/toptier_agencies.md type: APIReference - url: openapi/usaspending-openapi.yml type: OpenAPI description: Reference and typeahead data used to build and validate search filters across the rest of the API - toptier agency listings with budgetary-resources share, plus autocomplete lookups for awarding/funding agencies and sub-agency offices, recipients, CFDA assistance listings, NAICS and PSC codes, locations, and glossary terms. - aid: usaspending:usaspending-subawards-api name: USAspending Subawards API tags: - Subawards - Transactions - Prime Awards image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg humanURL: https://api.usaspending.gov/docs/endpoints baseURL: https://api.usaspending.gov/api/v2 properties: - url: https://api.usaspending.gov/docs/endpoints type: Documentation - url: https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspending_api/api_contracts/contracts/v2/subawards.md type: APIReference - url: openapi/usaspending-openapi.yml type: OpenAPI description: Paged, sortable listing of subawards (pass-through awards from a prime recipient to a subrecipient) scoped to a given prime award ID - subaward number, description, action date, amount, and subrecipient name. Powers the Sub-Awards tab on the USAspending.gov award profile page. common: - type: DomainSecurity url: security/usaspending-domain-security.yml - type: GitHubOrganization url: https://github.com/fedspendingtransparency - type: Website url: https://www.usaspending.gov - type: Documentation url: https://api.usaspending.gov/docs/endpoints - type: RateLimits url: rate-limits/usaspending-rate-limits.yml maintainers: - FN: Kin Lane email: kin@apievangelist.com