---
title: "Recent cycles"
method: GET
path: "/brands/{brandId}/cycles"
tags: ["measurement"]
---

# Recent cycles

`GET /brands/{brandId}/cycles`

## Request

- Base URL: `https://shruwd.io/api/v1`
- URL: `https://shruwd.io/api/v1/brands/{brandId}/cycles`
- Auth: HTTP bearer

## Query parameters

- `limit` integer

## Response `200`

Cycles, newest first.

- object
  - `cycles` Cycle[], required
    - `cycleId` string, required
    - `kind` 'scheduled' | 'recheck' | 'manual', required
    - `state` 'pending' | 'running' | 'complete' | 'partial' | 'failed' | 'skipped_quota', required: `partial` — some runs failed. `skipped_quota` — the allowance, the plan or billing stopped it.
    - `scheduledFor` string, date-time, required
    - `completedAt` string, date-time, nullable, required
    - `plannedRuns` integer, required
    - `completedRuns` integer, required
    - `failedRuns` integer, required

## Other responses

- `404`: `not_found`: no such resource in this workspace.
- `default`: Every failure has this body.

---

[API](https://skmtc.dev/shruwd/apis/shruwd-api.md) · [All operations](https://skmtc.dev/shruwd/apis/shruwd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shruwd/apis/shruwd-api/revisions/64a5da079928?raw)