---
title: "Bulk get DNA sequences by ID"
method: GET
path: "/dna-sequences:bulk-get"
tags: ["dnaSequences"]
---

# Bulk get DNA sequences by ID

`GET /dna-sequences:bulk-get`

## Request

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

Bulk get DNA sequences by ID

## Query parameters

- `dnaSequenceIds` string, required
- `returning` string

## Response `200`

OK

- DnaSequencesBulkGet
  - `dnaSequences` DnaSequence[]
    - `aliases` string[]
    - `annotations` DnaAnnotation[]
      - `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 DNA 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
    - `dnaAlignmentIds` string[]: API IDs of Nucleotide Alignments involving the RNA sequence
    - `entityRegistryId` string, nullable
    - `fields` Fields
    - `folderId` string, nullable
    - `id` string
    - `isCircular` boolean
    - `length` integer
    - `modifiedAt` string, date-time
    - `name` string
    - `parts` DnaSequencePart[]
      - `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
    - `transcriptions` DnaSequenceTranscription[]
      - `end` integer: 0-based exclusive end index. The end of the sequence is always represented as 0.
      - `sequenceId` string: Linked RNA sequence ID.
      - `start` integer: 0-based inclusive start index.
      - `strand` integer
    - `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)