---
title: "Changes to Retrieve application state for an SBI, grant code and version"
method: GET
path: "/state"
---

# Changes to Retrieve application state for an SBI, grant code and version

`GET /state`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 19 revisions.

- **2026-09-29** `d9470deb940a`: 1 info
- **2026-06-29** `047f9b2e19c3`: 1 info
- **2026-06-22** `e71a947428ee`: 11 info
- **2026-04-22** `7623fe906e93`: 1 breaking, 2 info
- **2026-04-15** `c9f9f7d113fd`: 1 info

## Changes

- **2026-09-29** `d9470deb940a`: 1 info
  - added the new optional `query` request parameter `applicationRef`
- **2026-06-29** `047f9b2e19c3`: 1 info
  - the endpoint scheme security `bearerAuth AND lockToken` was added to the API
- **2026-06-22** `e71a947428ee`: 11 info
  - added the optional property `_id` to the response with the `200` status
  - added the optional property `createdAt` to the response with the `200` status
  - added the optional property `major` to the response with the `200` status
  - added the optional property `minor` to the response with the `200` status
  - added the optional property `patch` to the response with the `200` status
  - added the optional property `pinnedMajor` to the response with the `200` status
  - added the optional property `updatedAt` to the response with the `200` status
  - added the required property `grantCode` to the response with the `200` status
  - added the required property `grantVersion` to the response with the `200` status
  - added the required property `sbi` to the response with the `200` status
  - added the required property `state` to the response with the `200` status
- **2026-04-22** `7623fe906e93`: 1 breaking, 2 info
  - the `query` request parameter `grantVersion` became required
  - `query` request parameter `grantVersion` list-of-types was widened by adding types `integer`
  - for the `query` request parameter `grantVersion`, the type was generalized from `string` to no type
- **2026-04-15** `c9f9f7d113fd`: 1 info
  - for the `query` request parameter `grantVersion`, the type was generalized from `integer` to `string`, and format from `int32` to no format

---

[Operation](https://skmtc.dev/defra/apis/grants-ui-backend-api/docs/state/get.md) - [API](https://skmtc.dev/defra/apis/grants-ui-backend-api.md) - [Page](https://skmtc.dev/defra/apis/grants-ui-backend-api/changes/state/get)