---
title: "Get Assembly by ID"
method: GET
path: "/api/v3/assembly/{assembly_id}"
tags: ["Assembly"]
---

# Get Assembly by ID

`GET /api/v3/assembly/{assembly_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/assembly/{assembly_id}`
- Auth: HTTP bearer

Get a single Assembly by ID.

## Path parameters

- `assembly_id` string, required

## Query parameters

- `returning` string[]
- `omit` string[]

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- Assembly: Represents a molecular cloning assembly that combines multiple DNA fragments into complete constructs. Assemblies model the process of joining fragment sequences (such as genes, promoters, and terminators) using methods like Gibson Assembly, Golden Gate, or restriction enzyme-based cloning. The assembly tracks the input fragments and resulting construct sequences, enabling design-to-experiment traceability. Assemblies can be organized in folders and support archiving when no longer needed.
  - `archiveReason` string, nullable
  - `archived` boolean
  - `createdAt` string, datetime: DateTime the Assembly was created
  - `creator` PrincipalRef
    - `__typename` string
    - `id` string, api_id
  - `folder` FolderRef
    - `__typename` string
    - `id` string, api_id
  - `id` string: Id of the Assembly
  - `modifiedAt` string, datetime: DateTime the Assembly was last modified
  - `name` string: Name of the Assembly

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