---
title: "GET /import/annotation/{jobId}"
method: GET
path: "/import/annotation/{jobId}"
---

# GET /import/annotation/{jobId}

`GET /import/annotation/{jobId}`

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

Gets information about an annotation import job.

## Path parameters

- `jobId` string, required

## Response `200`

Success

- GetAnnotationImportResponse
  - `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.
  - `statusMessage` string, required — The job's status message.
  - `creationTime` string, date-time, required — When the job was created.
  - `updateTime` string, date-time, required — When the job was updated.
  - `completionTime` string, date-time, required — When the job completed.
  - `items` AnnotationImportItemDetail[], required — The job's imported items.
    - `source` string, required — The source file's location in Amazon S3.
    - `jobStatus` 'SUBMITTED' | 'IN_PROGRESS' | 'CANCELLED' | 'COMPLETED' | 'FAILED' | 'COMPLETED_WITH_FAILURES', required — The item's job status.
  - `runLeftNormalization` boolean, required — The job's left normalization setting.
  - `formatOptions` FormatOptions, required — Formatting options for a file.
    - `tsvOptions` object — Options for a TSV file.
      - `readOptions` object — The file's read options.
        - `sep` string — The file's field separator.
        - `encoding` string — The file's encoding.
        - `quote` string — The file's quote character.
        - `quoteAll` boolean — Whether all values need to be quoted, or just those that contain quotes.
        - `escape` string — A character for escaping quotes in the file.
        - `escapeQuotes` boolean — Whether quotes need to be escaped in the file.
        - `comment` string — The file's comment character.
        - `header` boolean — Whether the file has a header row.
        - `lineSep` string — A line separator for the file.
    - `vcfOptions` object — Options for a VCF file.
      - `ignoreQualField` boolean — The file's ignore qual field setting.
      - `ignoreFilterField` boolean — The file's ignore filter field setting.
  - `annotationFields` object — The annotation schema generated by the parsed annotation data.

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