---
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

## Changes

- **2026-07-17** `e4f8bfb653cf` — 1 info
  - added the non-success response with the status `401`
- **2026-01-02** `44eb9688d352` — 1 info
  - endpoint added
- **2025-12-29** `f4c31924c89c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/txn2/apis/kubefwd-api/changes/v1/kubernetes/pods/:namespace/get.md)

---

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