---
title: "List services"
method: GET
path: "/v1/services"
tags: ["services"]
---

# List services

`GET /v1/services`

Fetch information about specific services (or all of them), ordered by service name.

## Query parameters

- `names` string

## Response `200`

List services.

- GetServicesResponse
  - `type` string — Response type, "sync".
  - `status-code` integer — HTTP response status code.
  - `status` string — The description of the HTTP status code. See the [IANA list](https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml).
  - `result` ServiceInfo[]
    - `name` string — Name of the service.
    - `startup` 'disabled' | 'enabled' — Configured startup value.
    - `current` 'active' | 'backup' | 'error' | 'inactive' — Current status of the service.
    - `current-since` string, date-time — [Time](#time) the service transitioned to the current status.

---

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