USAspending API ReferenceIndependent
Try the API

State Award Breakdown

GET/api/v2/recipient/state/awards/{fips}/
Powers State and territory profiles on usaspending.gov

This endpoint is used to power USAspending.gov's state profile pages. This data can be used to visualize the government spending that occurs in a specific state or territory.

This endpoint returns the award amounts and totals, based on award type, of a specific state or territory, given its USAspending.gov id.

Request

curl 'https://api.usaspending.gov/api/v2/recipient/state/awards/51/'

Path parameters

  • fipsstringRequired

    The FIPS code for the state you want to view. You must include leading zeros.

    Example 51

Query parameters

  • yearstring

    The fiscal year you would like data for. Use all to view all time or latest to view the latest 12 months.

    Example 2017

Try it

Runs against the live API. Responses are real data.

GET/api/v2/recipient/state/awards/51/?year=2017

Response · 200

  • typestringRequired

    Award types include 'contracts', 'grants', 'direct_payments', 'loans', 'other_financial_assistance'.

    Example contracts

  • amountnumberRequired

    The aggregate value of awards of this type.

    Example 41725.9

  • countnumberRequired

    The number of awards of this type.

    Example 4

  • total_outlaysnumberRequired

    The total outlays of awards of this type.

    Example 16572454209.94

Example response
[
  {
    "type": "contracts",
    "amount": 41725.9,
    "count": 4,
    "total_outlays": 16572454209.94
  }
]

Recent changes

Generated from contracts/v2/recipient/state/awards/fips.md in the USAspending API repo.

Loading…