---
title: "Get Sample Unit"
method: GET
path: "/samples/{id}"
tags: ["samples"]
---

# Get Sample Unit

`GET /samples/{id}`

## Request

- Base URL: `http://localhost:8125`
- URL: `http://localhost:8125/samples/{id}`
- Auth: HTTP basic

SampleUnit info for the given ID

## Path parameters

- `id` string, uuid, required

## Response `200`

The sample unit was retrieved successfully.

- SampleUnit
  - `formType` string
  - `id` string, uuid
  - `sampleSummaryFK` integer
  - `sampleUnitPK` integer
  - `sampleUnitRef` string
  - `sampleUnitType` string
  - `status` 'INIT' | 'DELIVERED' | 'PERSISTED' | 'FAILED'

## Other responses

- `401`: Authentication information is missing or invalid.
- `404`: Resource has not been found

## Changes

- **2021-09-14** `4937f3b06222`: 1 warning
  - removed the optional property `sampleAttributes` from the response with the `200` status

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-sample-service/changes/samples/:id/get.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-sample-service.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-sample-service/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-sample-service/revisions/6236ad7256ad?raw)