---
title: "List SLOs"
method: GET
path: "/slos"
tags: ["SLOs"]
---

# List SLOs

`GET /slos`

## Request

- Base URL: `https://api.marboba.com/v1`
- URL: `https://api.marboba.com/v1/slos`
- Auth: HTTP bearer

Lists every SLO in the calling token's org. Optional query filters: `appId`, `status`, `type`.

## Query parameters

- `appId` string
- `status` 'met' | 'atRisk' | 'breached'
- `type` 'availability' | 'latency' | 'errorRate' | 'throughput' | 'custom'

## Response `200`

List of SLOs

- object
  - `slos` Slo[]
    - `id` string, required
    - `name` string, required
    - `appId` string, required: Component the SLO applies to.
    - `type` 'availability' | 'latency' | 'errorRate' | 'throughput' | 'custom', required
    - `target` number, required: For availability/errorRate: percentage 0-100. For latency: percentile (e.g. 99 for p99). For throughput/custom: caller-defined units.
    - `unit` string, nullable
    - `window` 'rolling7d' | 'rolling30d' | 'rolling90d' | 'calendarMonth' | 'calendarQuarter', required
    - `currentValue` number, nullable
    - `errorBudgetTotal` number, nullable
    - `errorBudgetRemaining` number, nullable
    - `errorBudgetPercentUsed` number, nullable
    - `status` 'met' | 'atRisk' | 'breached', nullable
    - `dataSource` string, nullable
    - `lastUpdatedAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable

## Other responses

- `401` (unresolved $ref)

---

[API](https://skmtc.dev/marboba/apis/marboba-public-rest-api.md) · [All operations](https://skmtc.dev/marboba/apis/marboba-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marboba/apis/marboba-public-rest-api/revisions/5b96d525d88d?raw)
