---
title: "Get Unit Supplementary Data"
method: GET
path: "/v1/unit_data"
deprecated: true
---

# Get Unit Supplementary Data

`GET /v1/unit_data`

## Request

- The document declares no server URL.
- Auth: none declared

> **Deprecated.**

Retrieve supplementary data for a particular unit given the dataset id and identifier, return 404 if no data is returned.

Parameters:
dataset_id (str): The unique id of the dataset being queried.
identifier (str): The identifier of the particular unit on the data being queried.

## Query parameters

- `dataset_id` string, required
- `identifier` string, required

## Response `200`

Successful Response

- UnitDataset
  - `dataset_id` string, required
  - `survey_id` string, required
  - `period_id` string, required
  - `form_types` string[], required
  - `data` unknown, required

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error

## Changes

> 32 revisions in range; 2 not diffed.

- **2026-07-01** `9a87e51baf13`: 1 breaking, 7 info
  - the response's body type changed from no type to `object` for status `200`
  - api operation id `get_unit_supplementary_data_v1_unit_data_get` removed and replaced with `Get_unit_supplementary_data_v1_unit_data_get`
  - endpoint deprecated
  - added the required property `data` to the response with the `200` status
  - …4 more
- **2023-09-19** `581b6221203d`: 1 breaking, 1 warning
  - added the new required `query` request parameter `identifier`
  - deleted the `query` request parameter `unit_id`
- **2023-08-25** `ac59298eeeb5`: 5 info
  - api operation id `get_unit_supplementary_data_v1_unit_data_get` was added
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`
  - …1 more

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service/changes/v1/unit_data/get.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/supplementary-data-service/revisions/9a87e51baf13?raw)