---
title: "List AaAnnotation items"
method: GET
path: "/api/v3/aa-sequence/{aa_sequence_id}/annotations/items"
tags: ["AA Sequence"]
---

# List AaAnnotation items

`GET /api/v3/aa-sequence/{aa_sequence_id}/annotations/items`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/aa-sequence/{aa_sequence_id}/annotations/items`
- Auth: HTTP bearer

List AaAnnotation items.

## Path parameters

- `aa_sequence_id` string, required

## Query parameters

- `nextToken` string
- `pageSize` integer

## Response `200`

OK

- AaAnnotationPaginatedList
  - `items` AaAnnotation[]
    - `__typename` string
    - `aaSequence` AaSequenceRef
      - `__typename` string
      - `id` string, api_id
    - `color` string: Hex color when displaying the annotation.
    - `end` integer: 0-based exclusive end index.
    - `id` string: ID of the annotation.
    - `name` string: Name of the annotation.
    - `notes` string: Text notes on the annotation.
    - `start` integer: 0-based inclusive start index.
    - `type` string, nullable: Feature type of the annotation.
  - `nextToken` string, nullable

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/benchling/apis/benchling-api.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api/revisions/c9f087b98b8b?raw)