---
title: "List entities with matching amino acids"
method: POST
path: "/aa-sequences:match-amino-acids"
tags: ["aaSequences"]
---

# List entities with matching amino acids

`POST /aa-sequences:match-amino-acids`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/aa-sequences:match-amino-acids`
- Auth: HTTP bearer

Returns AA Sequences that exactly match the provided amino acids.

## Request body

- AaSequencesMatchBases
  - `aminoAcids` string, required
  - `archiveReason` 'NOT_ARCHIVED' | 'Other' | 'Archived'
  - `nextToken` string
  - `pageSize` integer
  - `registryId` string, nullable: ID of a registry. Restricts results to those registered in this registry. Specifying `null` returns unregistered items.
  - `sort` 'modifiedAt:asc' | 'modifiedAt:desc' | 'name:asc' | 'name:desc'

## Response `200`

A filtered list of AA Sequences

- AaSequencesPaginatedList
  - `aaSequences` AaSequence[]
    - `aliases` string[]: Array of aliases
    - `aminoAcids` string: Amino acids of the AA sequence.
    - `annotations` AaAnnotation[]: Array of annotation objects on the AA sequence.
      - `color` string
      - `end` integer: 0-based exclusive end index. The end of the AA sequence is always represented as 0.
      - `id` string
      - `name` string
      - `notes` string
      - `start` integer: 0-based inclusive start index.
      - `type` string
    - `apiURL` string, uri: The canonical url of the AA Sequence in the API.
    - `archiveRecord` ArchiveRecord
      - `reason` string
    - `authors` UserSummary[]
      - `handle` string
      - `id` string
      - `name` string
    - `createdAt` string, date-time: DateTime the AA sequence was created.
    - `creator` UserSummary
      - `handle` string
      - `id` string
      - `name` string
    - `customFields` CustomFields
    - `entityRegistryId` string, nullable: Registry ID of the AA sequence if registered.
    - `fields` Fields
    - `folderId` string, nullable: ID of the folder that contains the AA sequence.
    - `id` string: ID of the AA sequence.
    - `length` integer: Number of amino acids in the AA sequence.
    - `modifiedAt` string, date-time: DateTime the AA sequence was last modified.
    - `name` string: Name of the AA sequence.
    - `registrationOrigin` RegistrationOrigin
      - `originEntryId` string, nullable
      - `registeredAt` string, date-time
    - `registryId` string, nullable: Registry the AA sequence is registered in.
    - `schema` SchemaSummary
      - `id` string
      - `name` string
    - `url` string: The path of the web URL, omitting the tenant domain
    - `webURL` string, uri: URL of the AA sequence.
  - `nextToken` string

## Other responses

- `400`: Bad Request

---

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