---
title: "List components"
method: GET
path: "/components"
tags: ["Components"]
---

# List components

`GET /components`

List status page components in a project.

## Query parameters

- `projectId` string, uuid — Project to list components for. Auto-filled from CLI and SDK context when omitted.
- `limit` integer — Maximum number of components to return per page.
- `cursor` string, uuid — Cursor from a previous response's nextCursor to fetch the next page.
- `includeDeleted` union — When true, include inactive and merged components.
  - boolean
  - string

## Response `200`

OK

- object
  - `components` object[], required
    - `id` string, uuid, required
    - `projectId` string, uuid, required
    - `name` string, required
    - `description` string, nullable, required
    - `origin` 'user_declared' | 'code_detected' | 'log_observed', required
    - `lifecycle` 'active' | 'inactive' | 'merged', required
    - `observationState` 'observed' | 'stale' | 'unobserved', required
    - `registryRevision` integer, required
    - `canonicalComponentId` string, uuid, required
    - `mergedIntoComponentId` string, uuid, nullable, required
    - `currentStatus` 'operational' | 'degraded' | 'outage', required — Current health status of this component.
    - `firstSeenAt` string, date-time, required
    - `lastSeenAt` string, date-time, required
    - `deletedAt` string, date-time, nullable, required — Timestamp when this component became inactive or was deleted, if any.
    - `inactiveAt` string, date-time, nullable, required — Timestamp when this component became inactive, if any.
    - `inactiveReason` string, nullable, required — Reason recorded when this component became inactive.
    - `legacyStateUnknown` boolean, required — True only for migration-era inactive rows whose deactivation authority is unknown.
  - `nextCursor` string, uuid, nullable, required — Pass as 'cursor' to fetch the next page. Null when there are no more results.

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) · [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sazabi/sazabi-public-api/revisions/1d12b71c735a/schema)