---
title: "Get an SLO"
method: GET
path: "/1/slos/{datasetSlug}/{sloId}"
tags: ["SLOs"]
---

# Get an SLO

`GET /1/slos/{datasetSlug}/{sloId}`

Get an SLO by ID.

## Query parameters

- `detailed` boolean

## Response `200`

Success

- union
  - SLO
    - `id` string
    - `name` string, required — The name of the SLO.
    - `description` string — A nice description of the SLO's intent and context.
    - `sli` object, required — Reference to the [Calculated Field](/api/calculated-fields/) used as the indicator of event success.
      - `alias` string, required — The alias of the Calculated Field (also called Derived Column).
    - `time_period_days` integer, required — The time period, in days, over which the SLO will be evaluated.
    - `target_per_million` integer, required — The number of events out of one million (1,000,000) that you expected qualified events to succeed.
    - `tags` Tag[] — A list of key-value pairs to help identify the SLO.
      - `key` string, required — A key to identify the tag, lowercase letters only.
      - `value` string, required — A value for the tag, must begin with a lowercase letter, contain only alphanumeric characters (all letters lowercase) and special characters of `/` and `-` allowed.
    - `reset_at` string, date-time, nullable — The ISO8601-formatted time the SLO was last reset. The value will be `null` if the SLO has not yet been reset.
    - `created_at` string, date-time — The ISO8601-formatted time when the SLO was created.
    - `updated_at` string, date-time — The ISO8601-formatted time when the SLO was updated.
    - `dataset_slugs` unknown[] — The dataset(s) the SLO will be evaluated against. Required if using `__all__` in the path.
      - unknown
  - SLODetailedResponse
    - `id` string
    - `name` string, required — The name of the SLO.
    - `description` string — A nice description of the SLO's intent and context.
    - `sli` object, required — Reference to the [Calculated Field](/api/calculated-fields/) used as the indicator of event success.
      - `alias` string, required — The alias of the Calculated Field (also called Derived Column).
    - `time_period_days` integer, required — The time period, in days, over which the SLO will be evaluated.
    - `target_per_million` integer, required — The number of events out of one million (1,000,000) that you expected qualified events to succeed.
    - `tags` Tag[] — A list of key-value pairs to help identify the SLO.
      - `key` string, required — A key to identify the tag, lowercase letters only.
      - `value` string, required — A value for the tag, must begin with a lowercase letter, contain only alphanumeric characters (all letters lowercase) and special characters of `/` and `-` allowed.
    - `reset_at` string, date-time, nullable — The ISO8601-formatted time the SLO was last reset. The value will be `null` if the SLO has not yet been reset.
    - `created_at` string, date-time — The ISO8601-formatted time when the SLO was created.
    - `updated_at` string, date-time — The ISO8601-formatted time when the SLO was updated.
    - `dataset_slugs` unknown[] — The dataset(s) the SLO will be evaluated against. Required if using `__all__` in the path.
      - unknown

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Rate Limit Exceeded
- `default` — Error

---

[API](https://skmtc.net/honeycomb/apis/honeycomb-api.md) · [All operations](https://skmtc.net/honeycomb/apis/honeycomb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/honeycomb/honeycomb-api/revisions/117619fac2a5/schema)