Exclamation Mark Icon

This site is not intended to be an official resource for federal spending data. To submit official federal spending data, please visit USAspending.gov

API Endpoints

This page is intended for users who are already familiar with APIs. If you're not sure what endpoint means, and what GET and POST requests are, you may find the introductory tutorial more useful to start.

Endpoints do not currently require any authorization.

Status Codes

In general, status codes returned are as follows:

  • 200 if successful
  • 400 if the request is malformed
  • 500 for server-side errors

Endpoints and Methods

The currently available endpoints are listed below. Our data dictionary provides more comprehensive definitions of the technical terms and government-specific language we use in the API.

To reduce unnecessary data transfer, most endpoints return a default set of information about the items being requested. To override the default field list, use the fields, exclude, and verbose options (see POST Requests for more information).

Endpoint Index

Endpoint Methods Description
/api/v1/accounts/awards/ GET, POST Returns a list of financial account data by treasury account symbol, program activity, object class, and award
/api/v1/accounts/awards/:id GET, POST Returns a single treasury account symbol/program activity/object class/award record with all fields
/api/v1/accounts/awards/total/ POST Supports aggregation on treasury account symbol/program activity/object class/award records
/api/v1/awards/ GET, POST Returns a list of award records
/api/v1/awards/:id GET, POST Returns a single award record with all fields
/api/v1/awards/autocomplete/ POST Supports autocomplete on award records
/api/v1/awards/total/ POST Supports aggregation on award records
/api/v1/federal_accounts/ GET, POST Returns a list of federal accounts
/api/v1/federal_accounts/:id GET, POST Returns a single federal account record with all fields
/api/v1/federal_accounts/autocomplete/ POST Supports autocomplete on federal account records
/api/v2/financial_balances/agencies/ GET Returns financial balance information for a specified fiscal year and funding agency
/api/v1/tas/ GET, POST Returns a list of treasury appropriation accounts (TAS)
/api/v1/tas/:id GET, POST Returns a single treasury appropriation account record with all fields
/api/v1/tas/autocomplete/ POST Supports autocomplete on TAS records
/api/v1/tas/balances/ GET, POST Returns a list of appropriation account balances by fiscal year
/api/v1/tas/balances/total/ POST Supports aggregation on appropriation account records
/api/v1/tas/balances/quarters/ GET, POST Returns a list of appropriation account balances by fiscal quarter
/api/v1/tas/balances/quarters/total/ POST Supports aggregation on quarterly appropriation account records
/api/v1/tas/categories/ GET, POST Returns a list of appropriation account balances by fiscal year broken up by program activities and object class
/api/v1/tas/categories/total/ POST Supports aggregation on appropriation account (by category) records
/api/v1/tas/categories/quarters/ GET, POST Returns a list of appropriation account balances by fiscal quarter broken up by program activities and object class
/api/v1/tas/categories/quarters/total/ POST Supports aggregation on quarterly appropriation account (by category) records
/api/v1/subawards/ GET, POST Returns a list of subaward records
/api/v1/subawards/:id GET, POST Returns a single subaward record with all fields
/api/v1/subawards/autocomplete/ POST Supports autocomplete on subawards
/api/v1/subawards/total/ POST Supports aggregation on subawards
/api/v1/transactions/ GET, POST Returns a list of transactions - contracts, grants, loans, etc.
/api/v1/transactions/:id GET, POST Returns a single transaction record with all fields
/api/v1/transactions/total/ POST Supports aggregation on transaction records
/api/v1/references/agency/ GET, POST Returns a list of agency records
/api/v1/references/agency/autocomplete/ POST Supports autocomplete on agency records
/api/v1/references/cfda/ GET, POST Returns a list of CFDA Programs
/api/v1/references/cfda/:id GET, POST Returns a single CFDA program, with all fields
/api/v1/references/glossary/autocomplete/ POST Supports autocomplete on recipient records
/api/v1/references/locations/ POST Returns a list of locations - places of performance or vendor locations
/api/v1/references/locations/geocomplete/ POST Supports geocomplete queries, see Using the API
/api/v1/references/recipients/ GET, POST Returns a list of recipient records
/api/v1/references/recipients/:id GET, POST Returns a specific, detailed recipient record
/api/v1/references/recipients/autocomplete/ POST Supports autocomplete on recipient records
/api/v1/submissions/ GET, POST Returns a list of submissions
/api/v1/filter/ POST Returns a hash of the json body
/api/v1/hash/ POST Returns a previously input json body
/api/v2/award_spending/award_type/ GET Returns a list of total obligations by award_type
/api/v2/award_spending/recipient/ GET Returns a list of total obligations by recipient
/api/v2/financial_spending/object_class/ GET takes fiscal year and funding agency id as input, and returns that agency's obligated amounts to specific major object classes
/api/v2/budget_authority/agencies/ GET takes funding agency id as input, and returns that agency's budget authority by year. Accepts optional query parameter ?frec= for additional filtering.