---
title: "List cell measurements for a cell instance"
method: GET
path: "/cell_instances/{cell_instance_id}/cell_measurements"
tags: ["Cell Instances", "Cell Measurements"]
---

# List cell measurements for a cell instance

`GET /cell_instances/{cell_instance_id}/cell_measurements`

## Request

- Base URL: `https://api.ionworks.com`
- URL: `https://api.ionworks.com/cell_instances/{cell_instance_id}/cell_measurements`
- Auth: none declared

List cell measurements for an instance with pagination and filtering.

Filter parameters support Supabase filter operators:
- Text fields (name, created_by_email): Use ``ilike.%value%`` for partial
  match
- Date fields: Use ``gte.value``, ``lte.value``, etc.
- Date range: Use created_at_gt and created_at_lt for between queries

## Path parameters

- `cell_instance_id` string, uuid, required

## Query parameters

- `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.
- `name` 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
- `overlapping_since` string, nullable: Keep only measurements still running at or after this instant. A run that started earlier and continued into the window is kept; filtering on start_time alone would drop it.
- `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` 'name' | 'created_at' | 'updated_at' | 'start_time'
- `order` 'asc' | 'desc'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **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`: 1 breaking
  - for the `path` request parameter `cell_instance_id`, the format changed from no format to `uuid`
- **2026-09-14** `7baccf056192`: 1 info
  - added the new optional `query` request parameter `overlapping_since`

[Operation history](https://skmtc.dev/ionworks/apis/ionworks-api/changes/cell_instances/:cell_instance_id/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)