Reference data

Agencies, codes, glossary, data dictionary, and other lookups used across the site.

Open a row for parameters and ready-to-run samples. The full reference has every field and a live console.

GETAssistance Listing/api/v2/references/assistance_listing/{code}

This endpoint returns a list of Tier 1 Assistance Listings which is the code (first two numbers of CFDA code), the count of Tier 2 children, and the Tier 2 children.

{code} *

curl 'https://api.usaspending.gov/api/v2/references/assistance_listing/11'

Full reference and live console Contract

GETAward Types/api/v2/references/award_types/

This endpoint returns a JSON object representing the grouping of award types.

curl 'https://api.usaspending.gov/api/v2/references/award_types/'

Full reference and live console Contract

GETOpportunity Totals by CFDA/api/v2/references/cfda/totals/

This endpoint provides total values for all CFDAs.

curl 'https://api.usaspending.gov/api/v2/references/cfda/totals/'

Full reference and live console Contract

GETOpportunity Totals by CFDA/api/v2/references/cfda/totals/{cfda_code}/

This endpoint provides total values for requested CFDA.

{cfda_code} *

curl 'https://api.usaspending.gov/api/v2/references/cfda/totals/12.012/'

Full reference and live console Contract

GETCountries/api/v2/references/countries/

This endpoint returns countries found in the refcountrycode table on USAspending.

curl 'https://api.usaspending.gov/api/v2/references/countries/'

Full reference and live console Contract

GETData Dictionary/api/v2/references/data_dictionary/

This endpoint powers USAspending.gov's data dictionary page.

curl 'https://api.usaspending.gov/api/v2/references/data_dictionary/'

Full reference and live console Contract

GETGlossary/api/v2/references/glossary/

These endpoints are used to power USAspending.gov's glossary components.

?page?limit

curl 'https://api.usaspending.gov/api/v2/references/glossary/'

Full reference and live console Contract

GETNAICS List/api/v2/references/naics/

Used to power USAspending.gov's NAICS search component on the Advanced Search page.

curl 'https://api.usaspending.gov/api/v2/references/naics/'

Full reference and live console Contract

GETSingle NAICS And Descendants/api/v2/references/naics/{code}/

This endpoint helps traverse a tree stcructure used to power USAspending.gov's NAICS search component on the Advanced Search page.

{code} *

curl 'https://api.usaspending.gov/api/v2/references/naics/11/'

Full reference and live console Contract