---
title: "Get Sample Units from sample summary"
method: GET
path: "/samples/{samplesummaryId}/sampleunits"
tags: ["samples"]
---

# Get Sample Units from sample summary

`GET /samples/{samplesummaryId}/sampleunits`

## Request

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

Get Sample Units from sample summary

## Path parameters

- `samplesummaryId` string, uuid, required

## Query parameters

- `state` string

## Response `200`

The sample units were retrieved successfully.

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

## Other responses

- `400`: No sample unit found for sample summary.
- `401`: Authentication information is missing or invalid.
- `404`: Resource has not been found

## Changes

- **2021-09-14** `4937f3b06222`: 1 warning
  - removed the optional property `items/sampleAttributes` from the response with the `200` status
- **2021-09-09** `bab896f6da76`: 1 info
  - added the new optional `query` request parameter `state`

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/ras-rm-sample-service/changes/samples/:samplesummaryId/sampleunits/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)