USAspending API ReferenceIndependent
Try the API

Toptier Search

GET/api/v2/references/filter_tree/psc/{group}/{psc}/{psc2}/
Powers Search filter pickers on usaspending.gov How Advanced Search works

Returns PSCs under the provided PSC

Request

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

Path parameters

  • groupstringRequired

    Example Product

  • pscstringRequired

    Example 10

  • psc2stringRequired

    Example 1000

Try it

Runs against the live API. Responses are real data.

GET/api/v2/references/filter_tree/psc/Product/10/1000/

Response · 200

  • resultsarray of FilterTreeNodeRequired5 fields
    • idstringRequired
    • descriptionstringRequired
    • ancestorsarray of stringRequired
    • countnumberRequired
    • childrenarray of FilterTreeNodeRequiredNullable
Example response
{
  "results": [
    {
      "id": "AA",
      "ancestors": [
        "Research and Development"
      ],
      "description": "AGRICULTURE R&D",
      "count": 4,
      "children": null
    },
    {
      "id": "F",
      "ancestors": [
        "Service"
      ],
      "description": "NATURAL RESOURCES MANAGEMENT",
      "count": 3,
      "children": null
    }
  ]
}

Recent changes

No contract changes to this endpoint since October 2024. The changelog covers every endpoint.

Contract notes

  • The contract doesn't declare group and psc and psc2 in its URL template, so they were added here from the path.

Generated from contracts/v2/references/filter_tree/psc/group/psc/psc.md in the USAspending API repo.

Loading…