---
title: "Get a specific cell instance by id"
method: GET
path: "/cell_instances/{cell_instance_id}"
tags: ["Cell Instances"]
---

# Get a specific cell instance by id

`GET /cell_instances/{cell_instance_id}`

Retrieves a specific cell instance by its ID.

## Path parameters

- `cell_instance_id` string, required

## Response `200`

Successful Response

- CellInstance — Model representing a cell instance as returned by the API.
  - `name` string, required — Name of the cell instance (serial number)
  - `batch` string, nullable — Batch number/identifier
  - `date_manufactured` string, date, nullable — Date of manufacture
  - `measured_properties` object, nullable — Measured (not designed) properties of this specific cell, grouped by component. Numeric values use the Quantity format. Example: {'cathode': {'loading': {'value': 7.06, 'unit': 'mg.cm-2'}}, 'cell': {'initial_capacity': {'value': 1.08, 'unit': 'A.h'}}}. Designed properties (target loading, rated capacity) belong on the cell specification.
  - `notes` string, nullable — Free-text notes about the cell instance
  - `id` string, required — Unique identifier for the cell instance
  - `cell_specification_id` string, required — Foreign key to the cell specification
  - `organization_id` string, required — Organization this cell instance belongs to.
  - `project_id` string, required — Project this cell instance belongs to
  - `created_by` string, nullable — User ID of the user who created this instance
  - `created_by_email` string, nullable — Email of the user who created this instance
  - `created_at` string, date-time, required — Timestamp when the instance was created
  - `updated_at` string, date-time, required — Timestamp when the instance was last updated
  - `measurement_ids` object[], nullable — List of measurement IDs associated with the cell instance

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)