---
title: "POST /referencestore/{referenceStoreId}/references"
method: POST
path: "/referencestore/{referenceStoreId}/references"
---

# POST /referencestore/{referenceStoreId}/references

`POST /referencestore/{referenceStoreId}/references`

Retrieves the metadata of one or more reference genomes in a reference store.

For more information, see [Creating a reference store](https://docs.aws.amazon.com/omics/latest/dev/create-reference-store.html) in the _Amazon Web Services HealthOmics User Guide_.

## Path parameters

- `referenceStoreId` string, required

## Query parameters

- `maxResults` integer
- `nextToken` string

## Request body

- object
  - `filter` object — A filter for references.
    - `name` string — A name to filter on.
    - `md5` string — An MD5 checksum to filter on.
    - `createdAfter` string, date-time — The filter's start date.
    - `createdBefore` string, date-time — The filter's end date.

## Response `200`

Success

- ListReferencesResponse
  - `nextToken` string — A pagination token that's included if more results are available.
  - `references` ReferenceListItem[], required — A list of references.
    - `id` string, required — The reference's ID.
    - `arn` string, required — The reference's ARN.
    - `referenceStoreId` string, required — The reference's store ID.
    - `md5` string, required — The reference's MD5 checksum.
    - `status` 'ACTIVE' | 'DELETING' | 'DELETED' — The reference's status.
    - `name` string — The reference's name.
    - `description` string — The reference's description.
    - `creationTime` string, date-time, required — When the reference was created.
    - `updateTime` string, date-time, required — When the reference was updated.

## 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)