---
title: "List RNA sequences"
method: GET
path: "/rna-sequences"
tags: ["rnaSequences"]
---

# List RNA sequences

`GET /rna-sequences`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/rna-sequences`
- Auth: HTTP bearer

List RNA sequences

## Query parameters

- `pageSize` integer
- `nextToken` string
- `sort` 'createdAt' | 'createdAt:asc' | 'createdAt:desc' | 'modifiedAt' | 'modifiedAt:asc' | 'modifiedAt:desc' | 'name' | 'name:asc' | 'name:desc'
- `createdAt` string
- `modifiedAt` string
- `name` string
- `nameIncludes` string
- `bases` string
- `folderId` string
- `mentionedIn` string
- `projectId` string
- `registryId` string
- `schemaId` string
- `schemaFields` SchemaFieldsQueryParam
- `archiveReason` string
- `mentions` string
- `ids` string
- `entityRegistryIds.anyOf` string
- `names.anyOf` string
- `names.anyOf.caseSensitive` string
- `creatorIds` string
- `authorIds.anyOf` string
- `customNotationId` string
- `returning` string

## Response `200`

OK

- RnaSequencesPaginatedList
  - `nextToken` string
  - `rnaSequences` RnaSequence[]
    - `aliases` string[]
    - `alignmentIds` string[]: API IDs of Nucleotide Alignments involving the RNA sequence
    - `annotations` RnaAnnotation[]
      - `color` string: Hex color code used when displaying this feature in the UI.
      - `customFields` SequenceFeatureCustomField[]
        - `name` string: Name of the custom field
        - `value` string: Value of the custom field
      - `name` string
      - `notes` string
      - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
      - `start` integer: 0-based inclusive start index.
      - `strand` integer
      - `type` string
    - `apiURL` string, uri: The canonical url of the RNA Sequence in the API.
    - `archiveRecord` ArchiveRecord
      - `reason` string
    - `authors` UserSummary[]
      - `handle` string
      - `id` string
      - `name` string
    - `bases` string
    - `createdAt` string, date-time
    - `creator` UserSummary
      - `handle` string
      - `id` string
      - `name` string
    - `customFields` CustomFields
    - `customNotation` string, nullable: Representation of the RNA Sequence in the custom notation specified in the request. Null if no notation was specified.
    - `customNotationName` string, nullable: Name of the custom notation specified in the request. Null if no notation was specified.
    - `entityRegistryId` string, nullable
    - `fields` Fields
    - `folderId` string, nullable
    - `helm` string, nullable: Representation of the RNA Sequence in HELM syntax, including any chemical modifications.
    - `id` string
    - `isCircular` boolean
    - `length` integer
    - `modifiedAt` string, date-time
    - `name` string
    - `parts` RnaSequencePart[]
      - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
      - `sequenceId` string
      - `start` integer: 0-based inclusive start index.
      - `strand` integer
    - `primers` Primer[]
      - `bases` string
      - `bindPosition` integer
      - `color` string
      - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
      - `name` string
      - `oligoId` string
      - `overhangLength` integer
      - `start` integer: 0-based inclusive start index.
      - `strand` integer
    - `registrationOrigin` RegistrationOrigin
      - `originEntryId` string, nullable
      - `registeredAt` string, date-time
    - `registryId` string, nullable
    - `schema` SchemaSummary
      - `id` string
      - `name` string
    - `translations` Translation[]
      - `color` string: Hex color code used when displaying this feature in the UI.
      - `customFields` SequenceFeatureCustomField[]
        - `name` string: Name of the custom field
        - `value` string: Value of the custom field
      - `name` string
      - `notes` string
      - `aminoAcids` string
      - `coerceStartCodonToMethionine` boolean: Whether to override the translation of the start codon to Methionine. Has no effect when the start codon already translates to Methionine.
      - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
      - `geneticCode` 'STANDARD' | 'VERTEBRATE_MITOCHONDRIAL' | 'YEAST_MITOCHONDRIAL' | 'MOLD_PROTOZOAN_COELENTERATE_MITOCHONDRIAL_MYCOPLASMA_SPIROPLASMA' | 'INVERTEBRATE_MITOCHONDRIAL' | 'CILIATE_DASYCLADACEAN_HEXAMITA_NUCLEAR' | 'ECHINODERM_FLATWORM_MITOCHONDRIAL' | 'EUPLOTID_NUCLEAR' | 'BACTERIAL_ARCHAEAL_PLANT_PLASTID' | 'ALTERNATIVE_YEAST_NUCLEAR' | 'ASCIDIAN_MITOCHONDRIAL' | 'ALTERNATIVE_FLATWORM_MITOCHONDRIAL' | 'CHLOROPHYCEAN_MITOCHONDRIAL' | 'TREMATODE_MITOCHONDRIAL' | 'SCENEDESMUS_OBLIQUUS_MITOCHONDRIAL' | 'THRAUSTOCHYTRIUM_MITOCHONDRIAL' | 'RHABDOPLEURIDAE_MITOCHONDRIAL' | 'CANDIDATE_DIVISION_SR1_GRACILIBACTERIA' | 'PACHYSOLEN_TANNOPHILUS_NUCLEAR' | 'MESODINIUM_NUCLEAR' | 'PERITRICH_NUCLEAR' | 'CEPHALODISCIDAE_MITOCHONDRIAL_UAA_TYR': The genetic code to use when translating the nucleotide sequence into amino acids.
      - `regions` TranslationRegionsItems[]
        - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
        - `start` integer: 0-based inclusive start index.
      - `start` integer: 0-based inclusive start index.
      - `strand` integer
    - `url` string: The path of the web URL, omitting the tenant domain
    - `webURL` 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)