---
title: "List a container's contents"
method: GET
path: "/containers/{container_id}/contents"
tags: ["containers"]
---

# List a container's contents

`GET /containers/{container_id}/contents`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/containers/{container_id}/contents`
- Auth: HTTP bearer

List a container's contents

## Path parameters

- `container_id` string, required

## Response `200`

OK

- ContainerContentsList
  - `contents` ContainerContent[]
    - `batch` union
      - Batch
        - `archiveRecord` ArchiveRecord
          - `reason` string
        - `createdAt` string, date-time: DateTime at which the the result was created
        - `creator` UserSummary
          - `handle` string
          - `id` string
          - `name` string
        - `defaultConcentration` Measurement
          - `units` string, nullable, required: Can only be null if value is also null
          - `value` number, double, nullable, required: Can only be null if units is also null
        - `entity` union
          - object: aa_sequence variant
            - `entityType` 'aa_sequence', required: Discriminator value: aa_sequence
            - `id` string
            - `type` string
          - object: custom_entity variant
            - `entityType` 'custom_entity', required
            - `id` string
            - `type` string
          - object: dna_sequence variant
            - `entityType` 'dna_sequence', required
            - `id` string
            - `type` string
        - `fields` Fields
        - `id` string
        - `modifiedAt` string, date-time
        - `name` string
        - `schema` SchemaSummary
          - `id` string
          - `name` string
        - `webURL` string
      - InaccessibleResource
        - `inaccessibleId` string
        - `type` string: The type of this inaccessible item. Example values: "custom_entity", "container", "plate", "dna_sequence"
    - `concentration` Measurement
      - `units` string, nullable, required: Can only be null if value is also null
      - `value` number, double, nullable, required: Can only be null if units is also null
    - `entity` union
      - union
        - object: aa_sequence variant
          - `entityType` 'aa_sequence', required
          - `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.
        - object: custom_entity variant
          - `entityType` 'custom_entity', required
          - `aliases` string[]
          - `apiURL` string, uri: The canonical url of the Custom Entity in the API.
          - `archiveRecord` ArchiveRecord
            - `reason` string
          - `authors` UserSummary[]
            - `handle` string
            - `id` string
            - `name` string
          - `createdAt` string, date-time
          - `creator` CustomEntityWithEntityTypeCreator
            - `handle` string
            - `id` string
            - `name` string
          - `customFields` CustomFields
          - `entityRegistryId` string, nullable
          - `fields` Fields
          - `folderId` string, nullable
          - `id` string
          - `modifiedAt` string, date-time
          - `name` string
          - `registrationOrigin` RegistrationOrigin
            - `originEntryId` string, nullable
            - `registeredAt` string, date-time
          - `registryId` string, nullable
          - `schema` SchemaSummary
            - `id` string
            - `name` string
          - `url` string: The path of the web URL, omitting the tenant domain
          - `webURL` string
        - object: dna_oligo variant
          - `entityType` 'dna_oligo', required: Discriminator value: dna_oligo
        - object: dna_sequence variant
          - `entityType` 'dna_sequence', required
          - `aliases` string[]
          - `annotations` DnaAnnotation[]
            - `color` string: Hex color code used when displaying this feature in the UI.
            - `customFields` SequenceFeatureCustomField[]
              - …
            - `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
            - `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[]
              - …
            - `start` integer: 0-based inclusive start index.
            - `strand` integer
          - `url` string: The path of the web URL, omitting the tenant domain
          - `webURL` string
        - object: mixture variant
          - `entityType` 'mixture', required
          - `aliases` string[]
          - `allowMeasuredIngredients` boolean: Derived from the mixture's schema.
          - `amount` string: The positive numerical amount value of this mixture in string format (to preserve full precision). Pair with `units`. Supports scientific notation (1.23e4).
          - `apiURL` string, uri: The canonical url of the Mixture in the API.
          - `archiveRecord` ArchiveRecord
            - `reason` string
          - `authors` UserSummary[]
            - `handle` string
            - `id` string
            - `name` string
          - `createdAt` string, date-time
          - `creator` MixtureWithEntityTypeCreator
            - `handle` string
            - `id` string
            - `name` string
          - `customFields` CustomFields
          - `entityRegistryId` string, nullable
          - `fields` Fields
          - `folderId` string, nullable
          - `id` string
          - `ingredients` Ingredient[]: List of ingredients on this mixture.
            - `amount` string, nullable: The amount value of this ingredient in its mixture, in string format (to preserve full precision). Pair with `units`. Supports scientific notation (1.23e4). One ingredient on this mixture can have an amount value of `"QS"`.
            - `catalogIdentifier` string, nullable
            - `componentEntity` IngredientComponentEntity: The entity that uniquely identifies this component.
              - …
            - `componentLotContainer` ContainerLabels
              - …
            - `componentLotEntity` EntityLabels
              - …
            - `componentLotText` string, nullable: Text representing the component lot for this ingredient. This is only present if the mixture schema supports component lots in "text" format.
            - `hasParent` boolean
            - `notes` string, nullable
            - `targetAmount` string, nullable: The target amount for this ingredient such that this ingredient's proportion in its mixture would preserve the equivalent ingredient's proportion in the parent mixture. Pair with `units`.
            - `units` 'nL' | 'uL' | 'mL' | 'L' | 'mg' | 'g' | 'kg' | 'ug' | 'Units' | 'Cells' | 'mol' | 'mmol' | 'umol'
          - `modifiedAt` string, date-time
          - `name` string
          - `registrationOrigin` RegistrationOrigin
            - `originEntryId` string, nullable
            - `registeredAt` string, date-time
          - `registryId` string, nullable
          - `schema` SchemaSummary
            - `id` string
            - `name` string
          - `units` 'nL' | 'uL' | 'mL' | 'L' | 'g' | 'kg' | 'mg' | 'ug' | 'Units'
          - `webURL` string
        - object: molecule variant
          - `entityType` 'molecule', required
          - `aliases` string[]: Array of aliases.
          - `apiURL` string, uri: The canonical url of the Molecule in the API.
          - `archiveRecord` ArchiveRecord
            - `reason` string
          - `authors` UserSummary[]
            - `handle` string
            - `id` string
            - `name` string
          - `canonicalizedSmiles` string: The canonicalized chemical structure in SMILES format.
          - `createdAt` string, date-time: DateTime the Molecule was created.
          - `creator` UserSummary
            - `handle` string
            - `id` string
            - `name` string
          - `customFields` CustomFields
          - `entityRegistryId` string, nullable: Registry ID of the Molecule if registered.
          - `fields` Fields
          - `folderId` string, nullable: ID of the folder that contains the Molecule.
          - `id` string: ID of the Molecule.
          - `modifiedAt` string, date-time: DateTime the Molecule was last modified.
          - `name` string: Name of the Molecule.
          - `originalSmiles` string, nullable: The original chemical structure supplied by the user in SMILES format. Null if the user did not originally supply SMILES.
          - `registrationOrigin` RegistrationOrigin
            - `originEntryId` string, nullable
            - `registeredAt` string, date-time
          - `registryId` string, nullable: Registry the Molecule is registered in.
          - `schema` SchemaSummary
            - `id` string
            - `name` string
          - `webURL` string, uri: URL of the Molecule.
        - object: rna_oligo variant
          - `entityType` 'rna_oligo', required: Discriminator value: rna_oligo
        - object: rna_sequence variant
          - `entityType` 'rna_sequence', required
          - `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
            - `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
            - `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[]
              - …
            - `start` integer: 0-based inclusive start index.
            - `strand` integer
          - `url` string: The path of the web URL, omitting the tenant domain
          - `webURL` string
      - InaccessibleResource
        - `inaccessibleId` string
        - `type` string: The type of this inaccessible item. Example values: "custom_entity", "container", "plate", "dna_sequence"

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

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