---
title: "List pods in a namespace"
method: GET
path: "/v1/kubernetes/pods/{namespace}"
tags: ["Kubernetes"]
---

# List pods in a namespace

`GET /v1/kubernetes/pods/{namespace}`

Returns pods with status, ready state, restarts, and age. Filter by label selector or service name.

## Path parameters

- `namespace` string, required

## Query parameters

- `context` string
- `labelSelector` string
- `serviceName` string

## Response `200`

List of pods

- Response
  - `success` boolean
  - `data` object
  - `error` ErrorInfo
    - `code` string
    - `message` string
  - `meta` MetaInfo
    - `count` integer
    - `timestamp` string, date-time

## Other responses

- `401` — Missing or invalid API key
- `404` — Namespace not found

---

[API](https://skmtc.net/txn2/apis/kubefwd-api.md) · [All operations](https://skmtc.net/txn2/apis/kubefwd-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/txn2/kubefwd-api/versions/e4f8bfb653cf/schema)