Skip to main content
SLO & Service Quality/SLO
GETSLOSince 1.0SynchronousAuth Required

ListSLIs

List all SLI definitions available in the system.

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Request Inputs

This API requires no request parameters.

Responses

200 OK

On success, this API returns the following response structure.

  • itemsList

    Paginated list of SLI definitions matching the query.

    Example: (nested array)

    • idString

      Unique identifier of the SLI definition.

      Example: sli-abc123

    • nameString

      Human-readable name of the SLI.

      Example: api-availability

    • descriptionString

      Detailed description of what this SLI measures.

      Example: Ratio of successful HTTP requests to total requests

    • metricTypeString

      Metric category: availability | latency | throughput | error_rate.

      Example: availability

    • goodEventsQueryString

      PromQL expression counting good (successful) events.

      Example: sum(rate(http_requests_total{status=~"2.."}[5m]))

    • totalEventsQueryString

      PromQL expression counting all events (denominator).

      Example: sum(rate(http_requests_total[5m]))

    • unitString

      Unit of the measured metric (e.g., requests, ms).

      Example: requests

    • sourceProductString

      Product or service that owns this SLI.

      Example: zcf-api

    • createdAtString

      Timestamp when this SLI definition was created.

      Example: 2026-01-15T08:00:00Z

  • totalInteger

    Total number of SLI definitions available.

    Example: 25

  • limitInteger

    Maximum number of items returned per page.

    Example: 20

  • offsetInteger

    Number of items skipped before this page.

    Example: 20

Endpoint

GET/api/v1/slo/slis

/api/v1/slo/slis

Operation ID

ListSLIs

Permalink

Request Example

curl -X GET '{host}/api/v1/slo/slis' -H 'Authorization: Bearer {token}'

Response Example

200
{
  "items": [
    {}
  ],
  "total": 25,
  "limit": 20,
  "offset": 20
}

Change History

This API has no change history records yet.

View all change history