USAspending.gov

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.

9 APIs 0 Features
GovernmentFederal SpendingOpen DataContractsGrantsDATA ActTransparencyPublic Sector

APIs

USAspending Awards Search API

Advanced search across federal award spending (contracts, IDVs, grants, loans, direct payments, other financial assistance). Accepts a complex JSON filter object (award type, ag...

USAspending Agency API

Per-agency profile data keyed by toptier agency code - mission, website, budgetary resources, obligated and outlay amounts, awards, sub-agencies, and Disaster Emergency Fund Cod...

USAspending Recipient API

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 a...

USAspending Federal Account API

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 budge...

USAspending Budget Function API

Reference listings of the federal budget's functional classification - budget functions and budget subfunctions (for example, National Defense, Health, Income Security) used to ...

USAspending Disaster/Emergency Funding (COVID-19) API

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 r...

USAspending Bulk Download API

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 backen...

USAspending References & Autocomplete API

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 loo...

USAspending Subawards API

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,...

Collections

USAspending API

OPEN

Rate Limits

Usaspending Rate Limits

3 limits

RATE LIMITS

Resources

🔗
DomainSecurity
DomainSecurity
👥
GitHubOrganization
GitHubOrganization
🔗
Website
Website
🔗
Documentation
Documentation
🔗
RateLimits
RateLimits

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: USAspending API
  version: v2
items:
- info:
    name: Awards Search
    type: folder
  items:
  - info:
      name: Search spending by award.
      type: http
    http:
      method: POST
      url: https://api.usaspending.gov/api/v2/search/spending_by_award/
      body:
        type: json
        data: "{\n  \"subawards\": false,\n  \"limit\": 10,\n  \"page\": 1,\n  \"filters\": {\n    \"award_type_codes\": [\"\
          A\", \"B\", \"C\"],\n    \"time_period\": [{ \"start_date\": \"2018-10-01\", \"end_date\": \"2019-09-30\" }]\n \
          \ },\n  \"fields\": [\"Award ID\", \"Recipient Name\", \"Award Amount\", \"Awarding Agency\"]\n}"
    docs: Advanced search across award/subaward spending using a JSON filter object and requested field list.
- info:
    name: Agency
    type: folder
  items:
  - info:
      name: Agency overview.
      type: http
    http:
      method: GET
      url: https://api.usaspending.gov/api/v2/agency/:toptier_code/?fiscal_year=2026
      params:
      - name: toptier_code
        value: '020'
        type: path
        description: The toptier code of an agency (CGAC or FREC).
      - name: fiscal_year
        value: '2026'
        type: query
        description: The desired 'as of' fiscal year.
    docs: Returns basic profile information for the agency for the fiscal year specified.
- info:
    name: Recipient
    type: folder
  items:
  - info:
      name: List / search recipients.
      type: http
    http:
      method: POST
      url: https://api.usaspending.gov/api/v2/recipient/
      body:
        type: json
        data: "{\n  \"order\": \"desc\",\n  \"sort\": \"amount\",\n  \"page\": 1,\n  \"limit\": 50,\n  \"award_type\": \"\
          all\"\n}"
    docs: Returns a paged list of recipients, their level, UEI/DUNS, and award amount.
- info:
    name: Federal Accounts
    type: folder
  items:
  - info:
      name: Federal account detail.
      type: http
    http:
      method: GET
      url: https://api.usaspending.gov/api/v2/federal_accounts/:account_number/?fiscal_year=2022
      params:
      - name: account_number
        value: 011-1022
        type: path
        description: The Federal Account symbol (Agency Code-Main Account Code).
      - name: fiscal_year
        value: '2022'
        type: query
        description: The desired appropriations fiscal year.
    docs: Returns account title, bureau, and aggregated obligated/outlay/budgetary-resources totals for the federal account
      and its child Treasury Accounts.
- info:
    name: Budget Functions
    type: folder
  items:
  - info:
      name: List budget functions.
      type: http
    http:
      method: GET
      url: https://api.usaspending.gov/api/v2/budget_functions/list_budget_functions/
    docs: Returns all federal budget functions, ordered by title.
  - info:
      name: List budget subfunctions.
      type: http
    http:
      method: GET
      url: https://api.usaspending.gov/api/v2/budget_functions/list_budget_subfunctions/
    docs: Returns all federal budget subfunctions, optionally scoped to a parent budget function.
- info:
    name: Disaster
    type: folder
  items:
  - info:
      name: Disaster / emergency funding overview.
      type: http
    http:
      method: GET
      url: https://api.usaspending.gov/api/v2/disaster/overview/
    docs: Funding and spending detail from emergency/disaster supplemental appropriations (e.g. CARES Act COVID-19 relief),
      by Disaster Emergency Fund Code (DEFC).
- info:
    name: Bulk Download
    type: folder
  items:
  - info:
      name: Request bulk award data download.
      type: http
    http:
      method: POST
      url: https://api.usaspending.gov/api/v2/bulk_download/awards/
      body:
        type: json
        data: "{\n  \"filters\": {\n    \"prime_award_types\": [\"A\", \"B\", \"C\", \"D\"],\n    \"date_type\": \"action_date\"\
          ,\n    \"date_range\": { \"start_date\": \"2019-10-01\", \"end_date\": \"2020-09-30\" }\n  },\n  \"file_format\"\
          : \"csv\"\n}"
    docs: Begins generating a zip file of award data in CSV/TSV/pipe-delimited form for download.
  - info:
      name: Check bulk download status.
      type: http
    http:
      method: GET
      url: https://api.usaspending.gov/api/v2/bulk_download/status/?file_name=
      params:
      - name: file_name
        value: ''
        type: query
        description: The file name returned by the download-request endpoint.
    docs: Returns the generation status and download URL (once ready) for a previously requested bulk download file.
  - info:
      name: List agencies available for bulk download.
      type: http
    http:
      method: GET
      url: https://api.usaspending.gov/api/v2/bulk_download/list_agencies/
    docs: Returns the toptier/subtier agencies that can be used to scope a bulk award or account download.
- info:
    name: References & Autocomplete
    type: folder
  items:
  - info:
      name: List toptier agencies.
      type: http
    http:
      method: GET
      url: https://api.usaspending.gov/api/v2/references/toptier_agencies/?sort=percentage_of_total_budget_authority&order=desc
      params:
      - name: sort
        value: percentage_of_total_budget_authority
        type: query
      - name: order
        value: desc
        type: query
    docs: Returns all toptier agencies with budgetary resources and their share of total government budget authority.
  - info:
      name: Autocomplete awarding agency / office.
      type: http
    http:
      method: POST
      url: https://api.usaspending.gov/api/v2/autocomplete/awarding_agency_office/
      body:
        type: json
        data: "{\n  \"search_text\": \"Defense\"\n}"
    docs: Returns awarding agencies and sub-agency offices matching the specified search text.
  - info:
      name: Autocomplete recipient.
      type: http
    http:
      method: POST
      url: https://api.usaspending.gov/api/v2/autocomplete/recipient/
      body:
        type: json
        data: "{\n  \"search_text\": \"Lockheed\"\n}"
    docs: Returns recipients matching the specified search text, for use as a search filter.
- info:
    name: Subawards
    type: folder
  items:
  - info:
      name: List subawards for a prime award.
      type: http
    http:
      method: POST
      url: https://api.usaspending.gov/api/v2/subawards/
      body:
        type: json
        data: "{\n  \"page\": 1,\n  \"limit\": 15,\n  \"sort\": \"subaward_number\",\n  \"order\": \"desc\",\n  \"award_id\"\
          : \"25882628\"\n}"
    docs: Returns a paged, sortable list of subawards for the given prime award ID.
bundled: true