---
title: "List Service Accounts"
method: GET
path: "/api/v1/service_accounts"
tags: ["service_accounts", "api_keys"]
---

# List Service Accounts

`GET /api/v1/service_accounts`

Returns a list of service accounts.

Args:
    filter_model: Model that takes care of filtering, sorting and
        pagination.
    hydrate: Flag deciding whether to hydrate the output model(s)
        by including metadata fields in the response.

Returns:
    A list of service accounts matching the filter.

## Query parameters

- `hydrate` boolean
- `sort_by` string
- `logical_operator` 'or' | 'and' — Logical Ops to use to combine filters on list methods.
- `page` integer
- `size` integer
- `id` union
  - string, uuid
  - string
- `created` union
  - string, date-time
  - string
- `updated` union
  - string, date-time
  - string
- `name` string, nullable
- `description` string, nullable
- `active` union
  - boolean
  - string

## Response `200`

Successful Response

- PageServiceAccountResponse
  - `index` integer, required
  - `max_size` integer, required
  - `total_pages` integer, required
  - `total` integer, required
  - `items` ServiceAccountResponse[], required
    - `body` ServiceAccountResponseBody — Response body for service accounts.
      - `created` string, date-time, required
      - `updated` string, date-time, required
      - `active` boolean
    - `metadata` ServiceAccountResponseMetadata — Response metadata for service accounts.
      - `description` string
    - `resources` ServiceAccountResponseResources — Class for all resource models associated with the service account entity.
    - `id` string, uuid, required
    - `permission_denied` boolean
    - `name` string, required

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/zenml-io/apis/zenml-2.md) · [All operations](https://skmtc.net/zenml-io/apis/zenml-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zenml-io/zenml-2/versions/febb01b8bce3/schema)