---
title: "POST /import/annotations"
method: POST
path: "/import/annotations"
---

# POST /import/annotations

`POST /import/annotations`

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 import jobs.

## Query parameters

- `maxResults` integer
- `nextToken` string

## Request body

- object
  - `ids` ResourceIdentifier[] — IDs of annotation import jobs to retrieve.
  - `filter` object — A filter for annotation import jobs.
    - `status` 'SUBMITTED' | 'IN_PROGRESS' | 'CANCELLED' | 'COMPLETED' | 'FAILED' | 'COMPLETED_WITH_FAILURES' — A status to filter on.
    - `storeName` string — A store name to filter on.

## Response `200`

Success

- ListAnnotationImportJobsResponse
  - `annotationImportJobs` AnnotationImportJobItem[] — A list of jobs.
    - `id` string, required — The job's ID.
    - `destinationName` string, required — The job's destination annotation store.
    - `versionName` string, required — The name of the annotation store version.
    - `roleArn` string, required — The job's service role ARN.
    - `status` 'SUBMITTED' | 'IN_PROGRESS' | 'CANCELLED' | 'COMPLETED' | 'FAILED' | 'COMPLETED_WITH_FAILURES', required — The job's status.
    - `creationTime` string, date-time, required — When the job was created.
    - `updateTime` string, date-time, required — When the job was updated.
    - `completionTime` string, date-time — When the job completed.
    - `runLeftNormalization` boolean — The job's left normalization setting.
    - `annotationFields` object — The annotation schema generated by the parsed annotation data.
  - `nextToken` string — Specifies the pagination token from a previous request to retrieve the next page of results.

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