USAspending API ReferenceIndependent
Try the API

Subawards

POST/api/v2/subawards/
Powers Award summaries on usaspending.gov How an award summary is built

This endpoint returns a list of data that is associated with the award profile page.

This endpoint returns a filtered set of subawards.

Request

curl -X POST 'https://api.usaspending.gov/api/v2/subawards/' \
  -H 'Content-Type: application/json' \
  -d '{
  "page": 1,
  "limit": 15,
  "sort": "subaward_number",
  "order": "desc",
  "award_id": "25882628"
}'

Request body

  • pagenumberRequired

    Default 1

  • limitnumber

    Default 10

  • sortenum (string)Required
    Allowed values
    • subaward_number
    • id
    • description
    • action_date
    • amount
    • recipient_name
  • orderenum (string)Required
    Allowed values
    • asc
    • desc

    Default desc

  • award_idstring

    Either a "generated" natural award id (string) or a database surrogate award id (number). Generated award identifiers are preferred as they are effectively permanent. Surrogate award ids are retained for backward compatibility but are deprecated.

Try it

Runs against the live API. Responses are real data.

POST/api/v2/subawards/

Response · 200

  • resultsarray of SubawardResponseRequired6 fields
    • idnumberRequired
    • subaward_numberstringRequired
    • descriptionstringRequired
    • action_datestringRequired
    • amountnumberRequired
    • recipient_namestringRequired
  • page_metadataobject · PageMetadataObjectRequired5 fields
    • pagenumberRequired
    • nextnumberRequiredNullable
    • previousnumberRequiredNullable
    • hasNextbooleanRequired
    • hasPreviousbooleanRequired
Example response
{
  "page_metadata": {
    "page": 1,
    "next": 2,
    "previous": null,
    "hasNext": true,
    "hasPrevious": false
  },
  "results": [
    {
      "id": 119270129,
      "subaward_number": "Z981002",
      "description": "DEVELOPMENT OF A SELF-SUSTAINED WIRELESS INTEGRATED STRUCTURAL HEALTH MONITORING SYSTEM FOR HIGHWAY BRIDGES",
      "action_date": "2011-10-27",
      "amount": 110000,
      "recipient_name": "URS GROUP, INC."
    }
  ]
}

Recent changes

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

Loading…