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
Change pk from int to uuid
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.
Update API contracts for dredd failures
Set max value of 'limit' to 500
June 2026
Remove duplicate character
Update API contracts with new Assistance Type codes
Add-object-classes-initial
May 2026
Update NAICS filter to allow a list of strings
Update filter_search.md
Added new column data to documentation
Add new TAS data structure
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
Add Pydantic filters to view
NewCreated initial Search Endpoint Functionality
December 2025
Typo: replace paramater with parameter
November 2025
Adding county fips to location results
October 2025
Update api contract
Consolidate PaginationMixin to common/helper directory
Update api contract
Update to only show children when a code is provided
Update assistance_listing.md for dredd
Update assistance_listing.md
Fix dredd indexing
NewAdd new assistance listings endpoint
Add columns to custom download account api contract
September 2025
Add naics long description and update 2017 naics file
Update endpoints to include year_retired
Update test and api contract
Fix typo in api contract
Update endpoints.md and program_activities.md
Fix program_activity in request body in api contract
August 2025
Update api contract syntax again
Update api contract syntax again
Update api contract syntax again
Update api contract syntax
Update search_filters.md
Update api contract, add test
Update awards, subawards, and transaction indexes to include type for program activities and park values
Add missing parameters to api contract
Handle carriage return
NewNew endpoint for listing program activities under federal account
Add PARK to program_activity
July 2025
Add recipient_id to spending_by_transaction
Updating download accounts api contract
May 2025
Update api contract
April 2025
Add object_class back for unmentioned contracts in slack thread
Remove object_class from search endpoint api contracts
Change recipient autocomplete to return unique recipients
Update spending_level filter on spending_by_awards
Return top results for each location type
Assorted minor changes
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
Add spending_level to the response
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
Add spending_level filter
Fix float to show two decimal places
Remove fields from request body parameters, update endpoints
Update recipient_id description on API contracts where present
Revert spending_by_transaction.md
Re-add in TransactionResponse object
Fix api contract typos, remove unused imports
Updating api docs
Updating api docs
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 API contract
Update spending_by_category API contract
Update API documentation
January 2025
Update awarding agency API contract
Update API contract
Updating contracts to remove spaces
Updating Contracts and spending by category view
Update API Contracts
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 deprecation message
Update spending_over_time API contract
Updated api contract