---
title: "Retrieve list of all services"
method: GET
path: "/service"
tags: ["service"]
---

# Retrieve list of all services

`GET /service`

## Response `200`

Success

- Service[]
  - `spec` ServiceSpec — Configuration of a service
    - `id` integer — Unique identification
    - `frontend-address` FrontendAddress, required — Layer 4 address. The protocol is currently ignored, all services will behave as if protocol any is specified. To restrict to a particular protocol, use policy.
      - `ip` string — Layer 3 address
      - `protocol` 'tcp' | 'udp' | 'any' — Layer 4 protocol
      - `scope` 'external' | 'internal' — Load balancing scope for frontend address
      - `port` integer — Layer 4 port number
    - `backend-addresses` BackendAddress[] — List of backend addresses
      - `ip` string, required — Layer 3 address
      - `protocol` string — Layer 4 protocol (TCP, UDP, etc)
      - `port` integer — Layer 4 port number
      - `nodeName` string — Optional name of the node on which this backend runs
      - `state` 'active' | 'terminating' | 'terminating-not-serving' | 'quarantined' | 'maintenance' — State of the backend for load-balancing service traffic
      - `preferred` boolean — Indicator if this backend is preferred in the context of clustermesh service affinity. The value is set based on related annotation of global service. Applicable for active state only.
      - `weight` integer, nullable — Backend weight
      - `zone` string — Optional name of the zone in which this backend runs
    - `flags` object — Optional service configuration flags
      - `type` 'ClusterIP' | 'NodePort' | 'ExternalIPs' | 'HostPort' | 'LoadBalancer' | 'LocalRedirect' — Service type
      - `trafficPolicy` 'Cluster' | 'Local' — Service external traffic policy (deprecated in favor of extTrafficPolicy)
      - `extTrafficPolicy` 'Cluster' | 'Local' — Service external traffic policy
      - `intTrafficPolicy` 'Cluster' | 'Local' — Service internal traffic policy
      - `natPolicy` 'None' | 'Nat46' | 'Nat64' — Service protocol NAT policy
      - `healthCheckNodePort` integer — Service health check node port
      - `name` string — Service name (e.g. Kubernetes service name)
      - `namespace` string — Service namespace (e.g. Kubernetes namespace)
      - `cluster` string — Service cluster
    - `updateServices` boolean — Update all services selecting the backends with their given states (id and frontend are ignored)
  - `status` ServiceStatus — Configuration of a service
    - `realized` ServiceSpec — Configuration of a service
      - `id` integer — Unique identification
      - `frontend-address` FrontendAddress, required — Layer 4 address. The protocol is currently ignored, all services will behave as if protocol any is specified. To restrict to a particular protocol, use policy.
        - `ip` string — Layer 3 address
        - `protocol` 'tcp' | 'udp' | 'any' — Layer 4 protocol
        - `scope` 'external' | 'internal' — Load balancing scope for frontend address
        - `port` integer — Layer 4 port number
      - `backend-addresses` BackendAddress[] — List of backend addresses
        - `ip` string, required — Layer 3 address
        - `protocol` string — Layer 4 protocol (TCP, UDP, etc)
        - `port` integer — Layer 4 port number
        - `nodeName` string — Optional name of the node on which this backend runs
        - `state` 'active' | 'terminating' | 'terminating-not-serving' | 'quarantined' | 'maintenance' — State of the backend for load-balancing service traffic
        - `preferred` boolean — Indicator if this backend is preferred in the context of clustermesh service affinity. The value is set based on related annotation of global service. Applicable for active state only.
        - `weight` integer, nullable — Backend weight
        - `zone` string — Optional name of the zone in which this backend runs
      - `flags` object — Optional service configuration flags
        - `type` 'ClusterIP' | 'NodePort' | 'ExternalIPs' | 'HostPort' | 'LoadBalancer' | 'LocalRedirect' — Service type
        - `trafficPolicy` 'Cluster' | 'Local' — Service external traffic policy (deprecated in favor of extTrafficPolicy)
        - `extTrafficPolicy` 'Cluster' | 'Local' — Service external traffic policy
        - `intTrafficPolicy` 'Cluster' | 'Local' — Service internal traffic policy
        - `natPolicy` 'None' | 'Nat46' | 'Nat64' — Service protocol NAT policy
        - `healthCheckNodePort` integer — Service health check node port
        - `name` string — Service name (e.g. Kubernetes service name)
        - `namespace` string — Service namespace (e.g. Kubernetes namespace)
        - `cluster` string — Service cluster
      - `updateServices` boolean — Update all services selecting the backends with their given states (id and frontend are ignored)

---

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