NAICS List

GET/api/v2/references/naics/

Powers Reference data on usaspending.gov

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

This endpoint returns a list of Tier 1 NAICS codes, their descriptions, and a count of their Tier 3 grandchildren. If filter is provided then return parents/grandparents that match the search text.

Request

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

Try it

Runs against the live API. Responses are real data.

GET/api/v2/references/naics/

Response · 200

resultsarray of NAICSObjectRequired6 fields
- naicsstringRequired
- naics_descriptionstringRequired
- long_descriptionstring
- year_retirednumberRequired
- countnumberRequired
- childrenarray of NAICSObject

Example response

{
  "results": [
    {
      "naics": "",
      "naics_description": "",
      "year_retired": 0,
      "count": 0,
      "children": [
        {}
      ]
    }
  ]
}

Recent changes

September 30, 2025Mentioned in the September 30, 2025 release notes
September 15, 2025DEV-9334: Add naics long description and update 2017 naics file
September 11, 2025DEV-9331: Update endpoints to include year_retired
November 4, 2019Mentioned in the November 04, 2019 release notes

Generated from contracts/v2/references/naics.md in the USAspending API repo.