---
title: "Get steps and cycle metrics in one call"
method: GET
path: "/cell_measurements/{measurement_id}/steps_and_cycles"
tags: ["Cell Measurements"]
---

# Get steps and cycle metrics in one call

`GET /cell_measurements/{measurement_id}/steps_and_cycles`

## Request

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

Retrieve all steps and a budgeted cycle series together.

Fetches steps once and computes cycles from the same data, avoiding a double
fetch when both are needed. Returns ``{ steps: {...}, cycles: {...} }``.

``max_points`` bounds the **cycle** series only. Steps are returned complete
whatever it says, and deliberately: the client resolves step-within-cycle filters
against this table and builds its hover labels from it, so a decimated steps table
would make the same filter select different rows at different plot widths. The
cycle series is what gets drawn, and what a long-cycling test can make unbounded.

## Path parameters

- `measurement_id` string, uuid, required

## Query parameters

- `max_points` integer, nullable: Maximum rows of the CYCLE series; steps are always complete
- `columns` string, nullable: Comma-separated step columns to return; all when omitted. The cycle series is computed from the whole table either way.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `1a41e07d413c`: 1 info
  - added the new optional `query` request parameter `columns`
- **2026-09-30** `ea3d377fec1a`: 1 breaking
  - for the `path` request parameter `measurement_id`, the format changed from no format to `uuid`

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