---
title: "POST /sequencestore/{sequenceStoreId}/readsets"
method: POST
path: "/sequencestore/{sequenceStoreId}/readsets"
---

# POST /sequencestore/{sequenceStoreId}/readsets

`POST /sequencestore/{sequenceStoreId}/readsets`

Retrieves a list of read sets from a sequence store ID and returns the metadata in JSON format.

## Path parameters

- `sequenceStoreId` string, required

## Query parameters

- `maxResults` integer
- `nextToken` string

## Request body

- object
  - `filter` object — A filter for read sets.
    - `name` string — A name to filter on.
    - `status` 'ARCHIVED' | 'ACTIVATING' | 'ACTIVE' | 'DELETING' | 'DELETED' | 'PROCESSING_UPLOAD' | 'UPLOAD_FAILED' — A status to filter on.
    - `referenceArn` string — A genome reference ARN to filter on.
    - `createdAfter` string, date-time — The filter's start date.
    - `createdBefore` string, date-time — The filter's end date.
    - `sampleId` string — The read set source's sample ID.
    - `subjectId` string — The read set source's subject ID.
    - `generatedFrom` string — Where the source originated.
    - `creationType` 'IMPORT' | 'UPLOAD' — The creation type of the read set.

## Response `200`

Success

- ListReadSetsResponse
  - `nextToken` string — A pagination token that's included if more results are available.
  - `readSets` ReadSetListItem[], required — A list of read sets.
    - `id` string, required — The read set's ID.
    - `arn` string, required — The read set's ARN.
    - `sequenceStoreId` string, required — The read set's sequence store ID.
    - `subjectId` string — The read set's subject ID.
    - `sampleId` string — The read set's sample ID.
    - `status` 'ARCHIVED' | 'ACTIVATING' | 'ACTIVE' | 'DELETING' | 'DELETED' | 'PROCESSING_UPLOAD' | 'UPLOAD_FAILED', required — The read set's status.
    - `name` string — The read set's name.
    - `description` string — The read set's description.
    - `referenceArn` string — The read set's genome reference ARN.
    - `fileType` 'FASTQ' | 'BAM' | 'CRAM' | 'UBAM', required — The read set's file type.
    - `sequenceInformation` SequenceInformation — Details about a sequence.
      - `totalReadCount` integer — The sequence's total read count.
      - `totalBaseCount` integer — The sequence's total base count.
      - `generatedFrom` string — Where the sequence originated.
      - `alignment` string — The sequence's alignment setting.
    - `creationTime` string, date-time, required — When the read set was created.
    - `statusMessage` string — The status for a read set. It provides more detail as to why the read set has a status.
    - `creationType` 'IMPORT' | 'UPLOAD' — The creation type of the read set.
    - `etag` object — The entity tag (ETag) is a hash of the object representing its semantic content.
      - `algorithm` 'FASTQ_MD5up' | 'BAM_MD5up' | 'CRAM_MD5up' | 'FASTQ_SHA256up' | 'BAM_SHA256up' | 'CRAM_SHA256up' | 'FASTQ_SHA512up' | 'BAM_SHA512up' | 'CRAM_SHA512up' — The algorithm used to calculate the read set’s ETag(s).
      - `source1` string — The ETag hash calculated on Source1 of the read set.
      - `source2` string — The ETag hash calculated on Source2 of the read set.

## Other responses

- `480` — InternalServerException
- `481` — ThrottlingException
- `482` — ValidationException
- `483` — ResourceNotFoundException
- `484` — AccessDeniedException
- `485` — RequestTimeoutException

---

[API](https://skmtc.net/aws/apis/omics.md) · [All operations](https://skmtc.net/aws/apis/omics/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/omics/versions/e9df1bcc0813/schema)