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

## Request

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

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, uuid, 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'
- `include` string[], nullable: Extra fields to compute per spec. `thumbnail_url` adds `cad_thumbnail_url`, an hour-long signed URL of the CAD thumbnail (null when there is none).

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-04** `1f50d4b61910`: 1 info
  - added the new optional `query` request parameter `include`
- **2026-09-30** `ea3d377fec1a`: 1 breaking
  - 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_specifications/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)