USAspending API ReferenceIndependent
Try the API

API changelog

Changes to the API contracts since October 2024, newest first. Each entry links to the endpoints it touched and the commit that made it.

Built from the git history of the api_contracts folder in the USAspending API repo. Formatting-only and tooling commits are left out. For changes to the website, see the release notes.

September 2026

Update request example to use alternate id

Add message to required fields for filter search assistant

August 2026

NewInitial with integration tests

NewState codes endpoint - initial

July 2026

Updated Filter and Hash endpoints to use Pydantic validation, added size limit on request, and updated filter and hash contracts.

June 2026

May 2026

Update NAICS filter to allow a list of strings

Added new column data to documentation

Adding missing json close quotes

NewInitial filter-search endpoint documentation

April 2026

Update failing tests and remove program_activity

Reformatted search download time period block

Updated search timeperiods description

Fixed Syntax Error in Filters Fields in API Contract

Expanded Filters Fields in API Contract

Updated search.md api contract

NewCreated initial Search Endpoint Functionality

December 2025

Typo: replace paramater with parameter

November 2025

Adding county fips to location results

October 2025

Consolidate PaginationMixin to common/helper directory

Update to only show children when a code is provided

Update assistance_listing.md for dredd

NewAdd new assistance listings endpoint

Add columns to custom download account api contract

September 2025

Add naics long description and update 2017 naics file

August 2025

Update search_filters.md

Update api contract, add test

Update awards, subawards, and transaction indexes to include type for program activities and park values

NewNew endpoint for listing program activities under federal account

July 2025

Add recipient_id to spending_by_transaction

Updating download accounts api contract

May 2025

April 2025

Change recipient autocomplete to return unique recipients

Update spending_level filter on spending_by_awards

Return top results for each location type

Add unique award id for transaction filter

Fix API contract and cleanup integration tests

Added new fields to spending_by_award for subawards

March 2025

Add new fields to spending_by_transaction

Added new test cases and fixed name of primary_assistance_listing

Added other fields to spending_by_award

Added Recipient UEI field to spending_by_award

Remove fields from request body parameters, update endpoints

Re-add in TransactionResponse object

Fix api contract typos, remove unused imports

Updating api docs for transaction grouped.

NewAdd spending_by_subaward_grouped.md, clean up spending_by_award_grouped.py

Add SubawardTypeResult to contract and update SubawardSearch query

Renamed filter to award_unique_id

Updated to allow awards to be filtered on `prime_award_unique_id`

Update spending_by_award to accept new unique_award_id filter

Update API contract formatting

February 2025

Update delta SQL for subaward prime_award_recipient_id (#4295)

Update spending_by_category API contract

January 2025

December 2024

Add funding_opportunity_* to Award endpoint response

Update api contracts for search_by_geography

Update spending_by_geography api docs

Update reference to subwards in api docs

Updating api contracts for total_outlays

Updating api contracts for spending_by_geography

Update api contract for spending_by_geography

November 2024

Update API contract with spending_level in response

Update JSON field names in API contract

Update api contracts with county fips field description

Update api contracts with new county_fips field

October 2024

Add DEFC object to Data Structures/Filter Objects

Add def_codes to filter of award download api contract

Update spending_over_time API contract

Loading…