Agency profiles
Budgetary resources, obligations, and award spending for each agency.
Open a row for parameters and ready-to-run samples. The full reference has every field and a live console.
GETAgency Overview/api/v2/agency/{toptier_code}/
Returns some basic information regarding the agency for the fiscal year specified.
curl 'https://api.usaspending.gov/api/v2/agency/012/'GETAgency Awards/api/v2/agency/{toptier_code}/awards/
Returns the number of transactions and award obligations for a given agency and fiscal year.
curl 'https://api.usaspending.gov/api/v2/agency/020/awards/'GETOverview of new awards for Agency/api/v2/agency/{toptier_code}/awards/new/count
Return the count of new Awards under the Agency
curl 'https://api.usaspending.gov/api/v2/agency/086/awards/new/count'GETList Budget Function/api/v2/agency/{toptier_code}/budget_function/
Returns a list of Budget Function in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/086/budget_function/'GETBudget Function Count/api/v2/agency/{toptier_code}/budget_function/count/
Returns the count of unique Budget Functions in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/012/budget_function/count/'GETAgency Overview/api/v2/agency/{toptier_code}/budgetary_resources/
Returns budgetary resources and obligations for the agency and fiscal year requested.
curl 'https://api.usaspending.gov/api/v2/agency/075/budgetary_resources/'GETList Disaster Emergency Fund Codes/api/v2/agency/{toptier_code}/def_code/
Returns a list of Disaster Emergency Fund Codes in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/086/def_code/'GETList Federal Accounts/api/v2/agency/{toptier_code}/federal_account/
Returns a list of Federal Accounts and Treasury Accounts in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/086/federal_account/'GETFederal Account Count/api/v2/agency/{toptier_code}/federal_account/count/
Returns the count of unique Federal Account and Treasury Account categories in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/012/federal_account/count/'GETList Object Classes/api/v2/agency/{toptier_code}/object_class/
Returns a list of Object Classes in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/086/object_class/'GETObject Class Count/api/v2/agency/{toptier_code}/object_class/count/
Returns the count of Object Classes in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/012/object_class/count/'GETFederal Obligations/api/v2/agency/{toptier_code}/obligations_by_award_category/
This endpoint is used to power USAspending.gov's agency profile pages.
curl 'https://api.usaspending.gov/api/v2/agency/086/obligations_by_award_category/'GETList Program Activities/api/v2/agency/{toptier_code}/program_activity/
Returns a list of Program Activity in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/086/program_activity/'GETProgram Activity Count/api/v2/agency/{toptier_code}/program_activity/count/
Returns the count of Program Activity categories in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/012/program_activity/count/'GETList Federal Accounts/api/v2/agency/{toptier_code}/sub_agency/
Returns a list of Federal Accounts and Treasury Accounts in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/086/sub_agency/'GETSub-Agency Count/api/v2/agency/{toptier_code}/sub_agency/count/
Returns the count of unique Sub-Agencies and Offices associated with an agency for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/012/sub_agency/count/'GETList Sub-Components/api/v2/agency/{toptier_code}/sub_components/
Returns a list of Sub-Components in the Agency's appropriations for a single fiscal year
curl 'https://api.usaspending.gov/api/v2/agency/086/sub_components/'GETList Federal Accounts by Sub-Component/api/v2/agency/{toptier_code}/sub_components/{bureau_slug}/
Returns a list of Federal Accounts in the Agency's appropriations for a single fiscal year, filtered on the given Sub-Component
curl 'https://api.usaspending.gov/api/v2/agency/086/sub_components/bureau_of_the_census/'GETCount of awards for Agencies/api/v2/agency/awards/count
Returns the count of Awards grouped by Award Type under Agencies
curl 'https://api.usaspending.gov/api/v2/agency/awards/count'GETTreasury Account's Object Classes/api/v2/agency/treasury_account/{tas}/object_class/
Returns a list of Object Classes for the specified Treasury Account Symbol (tas).
curl 'https://api.usaspending.gov/api/v2/agency/treasury_account/001-X-0000-000/object_class/'GETTreasury Account's Program Activities/api/v2/agency/treasury_account/{tas}/program_activity/
Returns a list of Program Activities for the specified Treasury Account Symbol (tas).
curl 'https://api.usaspending.gov/api/v2/agency/treasury_account/001-X-0000-000/program_activity/'GETAgency Overview/api/v2/references/agency/{id}/
These endpoints are used to power USAspending.gov's agency profile pages.
curl 'https://api.usaspending.gov/api/v2/references/agency/456/'GETDABS Submission Window Dates/api/v2/references/submission_periods/
This endpoint provides a list of all fields in the "dabssubmissionwindowschedule" table except 'id'.
curl 'https://api.usaspending.gov/api/v2/references/submission_periods/'GETToptier Agency Profile/api/v2/references/toptier_agencies/
These endpoints are used to power USAspending.gov's agency profile pages.
curl 'https://api.usaspending.gov/api/v2/references/toptier_agencies/'GETTotal Government Budgetary Resources/api/v2/references/total_budgetary_resources/
This endpoint is used to provide information on the federal budgetary resources of the government.
curl 'https://api.usaspending.gov/api/v2/references/total_budgetary_resources/'