Exclamation Mark Icon

This site is not intended to be an official resource for federal spending data. To submit official federal spending data, please visit USAspending.gov

Award Recipes

These example requests are for the /api/v1/awards/ endpoint.

Get all Awards for a Specific Agency

This request will find all awards awarded by the Department of Defense, which is a top-tier agency with a CGAC code of '097'.

GET
/api/v1/awards/?awarding_agency__toptier_agency__cgac_code=097

POST

{
  "filters": [
    {
      "field": "awarding_agency__toptier_agency__cgac_code",
      "operation": "equals",
      "value": "097"
    }
  ]
}
Get all Awards with a Type of A, B, C, or D

This request will find all awards with types 'A' (BPA Call), 'B' (Purchase Order), 'C' (Delivery Order), or 'D' (Definitive Contract)

POST

{
  "filters": [
    {
      "field": "type",
      "operation": "in",
      "value": ["A", "B", "C", "D"]
    }
  ]
}
Get all Awards which have associated contract data

This request will find all awards with transactions that provide contract data.

POST

{
  "filters": [
    {
      "field": "transaction__contract_data",
      "operation": "is_null",
      "value": false
    }
  ]
}
Get all Awards where the Place of Performance is not in New Jersey

This request will find all awards whose place of performance is not in a location with a state code of 'NJ' (New Jersey)

POST

{
  "filters": [
    {
      "field": "place_of_performance__state_code",
      "operation": "not_equals",
      "value": "NJ"
    }
  ]
}

Postman Collections

Postman is a free app for making easy API requests. You can also use it to import and inspect a collection of pre-generated API requests. Here is a postman collection you can use to see how we generate the visualizations on the search page.