Search filter pickers

Type-ahead lookups that fill in agencies, recipients, locations, and industry codes.

POST19GET7Open on usaspending.gov How Advanced Search works

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

POSTAvailability Type Code/api/v2/autocomplete/accounts/a/

This endpoint powers the USAspending.gov Availability Type Code (A) autocomplete in the Advanced Search - Program Source - Treasury Account filter.

filterslimit

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/accounts/a/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "aid": "000"
  },
  "limit": 3
}'

Full reference and live console Contract

POSTAgency Identifier/api/v2/autocomplete/accounts/aid/

This endpoint powers the USAspending.gov Agency Identifier (AID) autocomplete in the Advanced Search - Program Source - Treasury and Federal Account filters.

filterslimit

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/accounts/aid/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "aid": "02"
  },
  "limit": 3
}'

Full reference and live console Contract

POSTAllocation Transfer Agency Identifier/api/v2/autocomplete/accounts/ata/

This endpoint powers the USAspending.gov Allocation Transfer Agency Identifier (ATA) autocomplete in the Advanced Search - Program Source - Treasury Account filter.

filterslimit

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/accounts/ata/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "ata": "02"
  },
  "limit": 3
}'

Full reference and live console Contract

POSTBeginning Period of Availability/api/v2/autocomplete/accounts/bpoa/

This endpoint powers the USAspending.gov Beginning Period of Availability (BPOA) autocomplete in the Advanced Search - Program Source - Treasury Account filter.

filterslimit

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/accounts/bpoa/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "bpoa": "201"
  },
  "limit": 3
}'

Full reference and live console Contract

POSTEnding Period of Availability/api/v2/autocomplete/accounts/epoa/

This endpoint powers the USAspending.gov Ending Period of Availability (EPOA) autocomplete in the Advanced Search - Program Source - Treasury Account filter.

filterslimit

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/accounts/epoa/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "epoa": "201"
  },
  "limit": 3
}'

Full reference and live console Contract

POSTMain Account Code/api/v2/autocomplete/accounts/main/

This endpoint powers the USAspending.gov Main Account Code (MAIN) autocomplete in the Advanced Search - Program Source - Treasury and Federal Account filters.

filterslimit

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/accounts/main/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "main": "30"
  },
  "limit": 3
}'

Full reference and live console Contract

POSTSub Account Code/api/v2/autocomplete/accounts/sub/

This endpoint powers the USAspending.gov Sub Account Code (SUB) autocomplete in the Advanced Search - Program Source - Treasury Account filter.

filterslimit

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/accounts/sub/' \
  -H 'Content-Type: application/json' \
  -d '{
  "filters": {
    "sub": "30"
  },
  "limit": 3
}'

Full reference and live console Contract

POSTAwarding Agency and Office Autocomplete/api/v2/autocomplete/awarding_agency_office/

This endpoint can be used to autocomplete Awarding Agency and Office searches on the Advanced Search page.

limitsearch_text

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/awarding_agency_office/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Defense"
}'

Full reference and live console Contract

POSTAwarding Agency Autocomplete/api/v2/autocomplete/awarding_agency/

Deprecated: Please see the following API contract for the new awarding endpoint usaspendingapi/apicontracts/contracts/v2/autocomplete/awardingagencyoffice.md.

limitsearch_text

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/awarding_agency/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Defense"
}'

Full reference and live console Contract

POSTCFDA Autocomplete/api/v2/autocomplete/cfda/

This endpoint is used by the Advanced Search page.

limitsearch_text

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/cfda/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Defense"
}'

Full reference and live console Contract

POSTAdvanced Search City Autocomplete/api/v2/autocomplete/city/

This end point returns a list of cities for a given limit, country, search string, and optional state code.

search_textlimitfilter

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/city/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Springfield",
  "limit": 40,
  "filter": {
    "country_code": "USA",
    "scope": "recipient_location",
    "state_code": "VA"
  }
}'

Full reference and live console Contract

POSTFunding Agency and Office Autocomplete/api/v2/autocomplete/funding_agency_office/

This endpoint can be used to autocomplete Funding Agency and Office searches on the Advanced Search page.

limitsearch_text

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/funding_agency_office/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Defense"
}'

Full reference and live console Contract

POSTFunding Agency Autocomplete/api/v2/autocomplete/funding_agency/

Deprecated: Please see the following API contract for the new funding endpoint usaspendingapi/apicontracts/contracts/v2/autocomplete/fundingagencyoffice.md.

limitsearch_text

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/funding_agency/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Defense"
}'

Full reference and live console Contract

POSTGlossary Autocomplete/api/v2/autocomplete/glossary/

This endpoint returns glossary autocomplete data for submitted text snippet.

search_textlimit

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/glossary/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Award"
}'

Full reference and live console Contract

POSTLocation Autocomplete/api/v2/autocomplete/location/

This endpoint is used by the Location autocomplete filter on the Advanced Search page.

limitsearch_text

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/location/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Den"
}'

Full reference and live console Contract

POSTNAICS Autocomplete/api/v2/autocomplete/naics/

This endpoint is used by the Advanced Search page.

limitsearch_text

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/naics/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Defense"
}'

Full reference and live console Contract

POSTPSC Autocomplete/api/v2/autocomplete/program_activity/

This endpoint is used by the Advanced Search page.

limitsearch_text

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/program_activity/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Meat"
}'

Full reference and live console Contract

POSTPSC Autocomplete/api/v2/autocomplete/psc/

This endpoint is used by the Advanced Search page.

limitsearch_text

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/psc/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Defense"
}'

Full reference and live console Contract

POSTRecipient Autocomplete/api/v2/autocomplete/recipient/

This endpoint is used by the Recipient autocomplete filter on the Advanced Search page.

limitsearch_textrecipient_levels

curl -X POST 'https://api.usaspending.gov/api/v2/autocomplete/recipient/' \
  -H 'Content-Type: application/json' \
  -d '{
  "search_text": "Holdings"
}'

Full reference and live console Contract

GETToptier Search/api/v2/references/filter_tree/psc/

Returns the basic groupings of Product Service Codes

curl 'https://api.usaspending.gov/api/v2/references/filter_tree/psc/'

Full reference and live console Contract

GETToptier Search/api/v2/references/filter_tree/psc/{group}/

Returns PSCs under the provided group

{group} *

curl 'https://api.usaspending.gov/api/v2/references/filter_tree/psc/Product/'

Full reference and live console Contract

GETToptier Search/api/v2/references/filter_tree/psc/{group}/{psc}/

Returns PSCs under the provided PSC

{group} *{psc} *

curl 'https://api.usaspending.gov/api/v2/references/filter_tree/psc/Product/10/'

Full reference and live console Contract

GETToptier Search/api/v2/references/filter_tree/psc/{group}/{psc}/{psc2}/

Returns PSCs under the provided PSC

{group} *{psc} *{psc2} *

curl 'https://api.usaspending.gov/api/v2/references/filter_tree/psc/Product/10/1000/'

Full reference and live console Contract

GETToptier Search/api/v2/references/filter_tree/tas/

Returns a list of toptier agencies that have at least one TAS affiliated with them

curl 'https://api.usaspending.gov/api/v2/references/filter_tree/tas/'

Full reference and live console Contract

GETSearch by Agency/api/v2/references/filter_tree/tas/{agency}/

Returns a list of federal accounts associated with the specified agency

{agency} *

curl 'https://api.usaspending.gov/api/v2/references/filter_tree/tas/020/'

Full reference and live console Contract

GETSearch by Federal Account/api/v2/references/filter_tree/tas/{agency}/{federal_account}/

Returns a list of Treasury Account Symbols associated with the specified federal account

{agency} *{federal_account} *

curl 'https://api.usaspending.gov/api/v2/references/filter_tree/tas/020/{federal_account}/'

Full reference and live console Contract