---
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`

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, required

## Query parameters

- `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.
- `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
- `order_by` 'name' | 'created_at' | 'updated_at' | 'start_time'
- `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)