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

# List cell measurements

`GET /cell_measurements`

## Request

- Base URL: `https://api.ionworks.com`
- URL: `https://api.ionworks.com/cell_measurements`
- Auth: none declared

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``, ``spec_id``, and ``spec_name`` / ``spec_anode`` /
``spec_cathode``, which are resolved to the matching specifications' ids.

``channel_id`` and ``protocol_id`` are exact match; text takes
``ilike.%value%`` and dates ``gte.value`` / ``lte.value``. ``tags_all`` /
``tags_any`` match case-insensitively against the project's tag spellings.

## Query parameters

- `cell_specification_id` string, uuid, nullable
- `project_id` string, uuid, nullable
- `measurement_type` string, nullable: Filter by measurement type: a bare value, `eq.`, `neq.` or `in.(a,b)`.
- `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
- `spec_name` string, nullable: Filter on the parent specification's name (`ilike.%x%`).
- `spec_anode` string, nullable: Filter on the parent specification's anode material name.
- `spec_cathode` string, nullable: Filter on the parent specification's cathode material name.
- `tags_all` string[], nullable: Only measurements carrying every one of these tags (repeatable: `tags_all=a&tags_all=b`).
- `tags_any` string[], nullable: Only measurements carrying at least one of these tags (repeatable).
- `meta` string[], nullable: Filter on a JSON metadata leaf (repeatable): `<source>:<path>:<number|text>:<op>.<value>`, e.g. `instance:anode.loading.value:number:gt.3`. Sources and paths come from `GET /cell_measurements/metadata_fields`.
- `order_by` 'id' | 'name' | 'created_at' | 'updated_at' | 'start_time' | 'cell_instance_id' | 'notes'
- `order` 'asc' | 'desc'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-11** `d3e6ef342a9d`: 3 info
  - added the new optional `query` request parameter `spec_anode`
  - added the new optional `query` request parameter `spec_cathode`
  - added the new optional `query` request parameter `spec_name`
- **2026-10-06** `6fbec094b30e`: 1 info
  - added the new optional `query` request parameter `meta`
- **2026-10-04** `1f50d4b61910`: 2 info
  - added the new optional `query` request parameter `tags_all`
  - added the new optional `query` request parameter `tags_any`
- **2026-09-30** `ea3d377fec1a`: 3 breaking
  - removed the enum value `step_labels_validated` from the `query` request parameter `order_by`
  - for the `query` request parameter `cell_specification_id`, the format of property `anyOf[subschema #1]/` was specialized from no format to `uuid`
  - for the `query` request parameter `project_id`, the format of property `anyOf[subschema #1]/` was specialized from no format to `uuid`

[Operation history](https://skmtc.dev/ionworks/apis/ionworks-api/changes/cell_measurements/get.md)

---

[API](https://skmtc.dev/ionworks/apis/ionworks-api.md) - [All operations](https://skmtc.dev/ionworks/apis/ionworks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ionworks/apis/ionworks-api/revisions/abebbbc5f60a?raw)