---
title: "POST /annotationStores"
method: POST
path: "/annotationStores"
---

# POST /annotationStores

`POST /annotationStores`

Amazon Web Services HealthOmics variant stores and annotation stores are no longer open to new customers. Existing customers can continue to use the service as normal. For more information, see [Amazon Web Services HealthOmics variant store and annotation store availability change](https://docs.aws.amazon.com/omics/latest/dev/variant-store-availability-change.html).

Retrieves a list of annotation stores.

## Query parameters

- `maxResults` integer
- `nextToken` string

## Request body

- object
  - `ids` ResourceIdentifier[] — IDs of stores to list.
  - `filter` object — A filter for annotation stores.
    - `status` 'CREATING' | 'UPDATING' | 'DELETING' | 'ACTIVE' | 'FAILED' — A status to filter on.

## Response `200`

Success

- ListAnnotationStoresResponse
  - `annotationStores` AnnotationStoreItem[] — A list of stores.
    - `id` string, required — The store's ID.
    - `reference` object, required — The store's genome reference.
      - `referenceArn` string — The reference's ARN.
    - `status` 'CREATING' | 'UPDATING' | 'DELETING' | 'ACTIVE' | 'FAILED', required — The store's status.
    - `storeArn` string, required — The store's ARN.
    - `name` string, required — The store's name.
    - `storeFormat` 'GFF' | 'TSV' | 'VCF', required — The store's file format.
    - `description` string, required — The store's description.
    - `sseConfig` object, required — The store's server-side encryption (SSE) settings.
      - `type` 'KMS', required — The encryption type.
      - `keyArn` string — An encryption key ARN.
    - `creationTime` string, date-time, required — The store's creation time.
    - `updateTime` string, date-time, required — When the store was updated.
    - `statusMessage` string, required — The store's status message.
    - `storeSizeBytes` integer, required — The store's size in bytes.
  - `nextToken` string — A pagination token that's included if more results are available.

## Other responses

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

---

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