---
title: "List cell specifications for the current organization"
method: GET
path: "/cell_specifications"
tags: ["Cell Specifications"]
---

# List cell specifications for the current organization

`GET /cell_specifications`

List cell specifications with pagination and optional filtering.

With ``project_id``, only specs linked to that project; without it, every
spec in the organization.

Material reverse-lookup: ``material_id``/``material_ids`` search all slots, a
per-slot ``<slot>_material_id`` only that slot, and ``exclude_cell_spec_id``
drops one spec. These take precedence over the text/date filters, which use
Supabase operators (``ilike.%value%``, ``gte.value``); ``created_at_gt``/
``_lt`` bound a range. ``q`` is the search box's free-text param.

## Query parameters

- `full` boolean
- `project_id` string, nullable
- `limit` integer
- `offset` integer
- `q` string, nullable — Free-text search on cell specification name plus prefix full-text match, matching the global search. Composes with the column filters.
- `name` string, nullable
- `form_factor` string, nullable
- `anode` string, nullable
- `cathode` string, nullable
- `material_id` string, nullable
- `material_ids` string[], nullable
- `anode_material_id` string, nullable
- `cathode_material_id` string, nullable
- `electrolyte_material_id` string, nullable
- `separator_material_id` string, nullable
- `case_material_id` string, nullable
- `exclude_cell_spec_id` string, nullable
- `created_by_email` 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'
- `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)