---
title: "Changes to Search federal awards"
method: GET
path: "/api/v1/usaspending/awards"
---

# Changes to Search federal awards

`GET /api/v1/usaspending/awards`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 21 revisions.

- **2026-08-28** `560e8847c7b3` — 7 breaking, 1 info
- **2026-08-21** `a83e6a561bf2` — 3 breaking, 5 warning, 2 info
- **2026-08-08** `4c4530760ba1` — 12 info

## Changes

- **2026-08-28** `560e8847c7b3` — 7 breaking, 1 info
  - the response property `data/award_type` became optional for the status `200`
  - the response property `data/fiscal_year` became optional for the status `200`
  - the response property `data/keyword` became optional for the status `200`
  - the response property `data/results` became optional for the status `200`
  - response property `data/award_type` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/fiscal_year` list-of-types was widened by adding types `null and number` to media type `application/json` of response `200`
  - response property `data/results` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added `subschema #1, subschema #2` to the `data/keyword` response property `anyOf` list for the response status `200`
- **2026-08-21** `a83e6a561bf2` — 3 breaking, 5 warning, 2 info
  - added `#/components/schemas/UpstreamErrorResponse, subschema #2` to the response body `oneOf` list for the response status `503`
  - the response's body type/format changed from `object`/`` to ``/`` for status `503`
  - removed the required property `error` from the response with the `503` status
  - removed the optional property `code` from the response with the `503` status
  - removed the optional property `detail` from the response with the `503` status
  - removed the optional property `hint` from the response with the `503` status
  - removed the optional property `plan` from the response with the `503` status
  - removed the optional property `reason` from the response with the `503` status
  - added the non-success response with the status `502`
  - added the non-success response with the status `504`
- **2026-08-08** `4c4530760ba1` — 12 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `429` status
  - added the optional property `code` to the response with the `503` status
  - added the optional property `hint` to the response with the `401` status
  - added the optional property `hint` to the response with the `429` status
  - added the optional property `hint` to the response with the `503` status
  - added the optional property `plan` to the response with the `401` status
  - added the optional property `plan` to the response with the `429` status
  - added the optional property `plan` to the response with the `503` status
  - added the optional property `reason` to the response with the `401` status
  - added the optional property `reason` to the response with the `429` status
  - added the optional property `reason` to the response with the `503` status

---

[Operation](https://skmtc.dev/sugra/apis/sugra-api/docs/api/v1/usaspending/awards/get.md) · [API](https://skmtc.dev/sugra/apis/sugra-api.md) · [Page](https://skmtc.dev/sugra/apis/sugra-api/changes/api/v1/usaspending/awards/get)