---
title: "List all service groups"
method: GET
path: "/gateway_manager/v1/service-groups"
tags: ["Gateway Manager"]
---

# List all service groups

`GET /gateway_manager/v1/service-groups`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/gateway_manager/v1/service-groups`
- Auth: none declared

Returns information about all service groups, optionally filtered by cluster_id.

## Query parameters

- `cluster_id` string

## Response `200`

A list of all service groups that the user has access to

- GatewayManagerGetServiceGroupsResponse200
  - `state` string
  - `results` GatewayManagerV1ServiceGroupsGetResponsesContentApplicationJsonSchemaResultsItems[]
    - `_id` string: The Id of the service group within the database
    - `name` string
    - `cluster_id` string
    - `is_default` boolean
    - `description` string
    - `created` string, date-time
    - `created_by` string
    - `last_updated` string, date-time
    - `last_updated_by` string
    - `groups` string[]
    - `services` GatewayManagerV1ServiceGroupsGetResponsesContentApplicationJsonSchemaResultsItemsServicesItems[]
      - `id` string
      - `name` string

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Gateway Manager` added
  - api tag `gatewayManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/gateway_manager/v1/service-groups/get.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)