---
title: "Create sample summary"
method: POST
path: "/samples/samplesummary"
tags: ["samples"]
---

# Create sample summary

`POST /samples/samplesummary`

Create sample summary

## Request body

- SampleSummary
  - `effectiveEndDateTime` string, date-time
  - `effectiveStartDateTime` string, date-time
  - `errorCode` 'None' | 'NotCsv' | 'DataError' | 'NotSpecified'
  - `expectedCollectionInstruments` integer
  - `id` string, uuid
  - `ingestDateTime` string, date-time
  - `notes` string
  - `state` 'ACTIVE' | 'INIT' | 'FAILED'
  - `surveyRef` string
  - `totalSampleUnits` integer

## Response `200`

The sample summary was created successfully.

- SampleSummary
  - `effectiveEndDateTime` string, date-time
  - `effectiveStartDateTime` string, date-time
  - `errorCode` 'None' | 'NotCsv' | 'DataError' | 'NotSpecified'
  - `expectedCollectionInstruments` integer
  - `id` string, uuid
  - `ingestDateTime` string, date-time
  - `notes` string
  - `state` 'ACTIVE' | 'INIT' | 'FAILED'
  - `surveyRef` string
  - `totalSampleUnits` integer

## Other responses

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

---

[API](https://skmtc.net/office-of-national-statistics/apis/ras-rm-sample-service.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/ras-rm-sample-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/ras-rm-sample-service/revisions/6236ad7256ad/schema)