---
title: "List cell measurements"
method: GET
path: "/cell_measurements"
tags: ["Cell Measurements"]
---

# List cell measurements

`GET /cell_measurements`

List cell measurements, scoped to a cell specification or a project.

Exactly one of ``cell_specification_id`` (all instances of that spec, page
size 1000) or ``project_id`` (paginated, parent instance fields joined, page
size 25) is required. ``project_id`` also accepts ``instance_name``,
``cell_instance_id`` and ``spec_id``.

``channel_id`` and ``protocol_id`` are exact match; text takes
``ilike.%value%`` and dates ``gte.value`` / ``lte.value``.

## Query parameters

- `cell_specification_id` string, nullable
- `project_id` string, nullable
- `measurement_type` 'time_series' | 'file' | 'properties' — Shape of the data stored in a cell measurement. - ``time_series`` — cycling / diagnostic data uploaded as columnar time series (and optional step summaries). Default for new measurements. - ``file`` — an opaque file upload (raw cycler export, image, other binary). Metadata about the file is captured in ``file_metadata``; the file content lives in object storage. - ``properties`` — a flat key/value set of measured properties (thickness, mass, DCIR, initial capacity, …) with no time-series data. Numeric values use the Quantity format.
- `limit` integer
- `offset` integer
- `q` string, nullable — Free-text search on measurement name and search_vector.
- `id` string, nullable
- `id_text` string, nullable
- `name` string, nullable
- `channel_id` string, nullable
- `protocol_id` string, nullable
- `created_by_email` string, nullable
- `start_time` string, nullable
- `start_time_gt` string, nullable
- `start_time_lt` string, nullable
- `created_at` string, nullable
- `created_at_gt` string, nullable
- `created_at_lt` string, nullable
- `updated_at` string, nullable
- `updated_at_gt` string, nullable
- `updated_at_lt` string, nullable
- `instance_name` string, nullable
- `cell_instance_id` string, nullable
- `cell_instance_id_text` string, nullable
- `spec_id_text` string, nullable
- `spec_id` string, nullable
- `order_by` 'id' | 'name' | 'created_at' | 'updated_at' | 'start_time' | 'cell_instance_id' | 'step_labels_validated' | 'notes'
- `order` 'asc' | 'desc'

## Response `200`

Successful Response

- unknown

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