---
title: "List persistent volume claims by namespace"
method: GET
path: "/persistentvolumeclaims/{namespace}"
tags: ["persistentvolumeclaims"]
---

# List persistent volume claims by namespace

`GET /persistentvolumeclaims/{namespace}`

Returns a list of persistent volume claims in a specific namespace.

## Path parameters

- `namespace` string, required

## Response `200`

Successful PVCs response

- ApiPVCListEnvelope
  - `data` PvcsPVCListItem[], required
    - `audit` CommonAudit, required
      - `createdAt` string, required
      - `createdBy` string, required
      - `deletedAt` string, required
      - `updatedAt` string, required
      - `updatedBy` string, required
    - `canMount` boolean, required
    - `canUpdate` boolean, required
    - `name` string, required
    - `pods` PvcsPodInfo[], required
      - `name` string, required
      - `node` PvcsPodNode
        - `name` string, required
      - `phase` 'Pending' | 'Running' | 'Succeeded' | 'Failed' | 'Unknown', required
    - `pv` PvcsPVInfo
      - `accessModes` V1PersistentVolumeAccessMode[], required
      - `name` string, required
      - `persistentVolumeReclaimPolicy` 'Recycle' | 'Delete' | 'Retain', required
      - `storageClass` PvcsStorageClassInfo
        - `description` string, required
        - `displayName` string, required
        - `name` string, required
      - `volumeMode` 'Block' | 'Filesystem', required
    - `pvcSpec` PvcsPVCSpec, required
      - `accessModes` V1PersistentVolumeAccessMode[], required
      - `requests` PvcsStorageRequests, required
        - `storage` string, required
      - `storageClassName` string, required — This field may be an empty string in two cases: 1. The PVC is requesting the default storage class, and it has not been bound to a PV yet. 2. The PVC is explicitly requesting a PV with no storage class (i.e. manual or out-of-band binding).
      - `volumeMode` 'Block' | 'Filesystem', required
    - `workspaces` PvcsWorkspaceInfo[], required
      - `name` string, required
      - `podTemplatePod` PvcsPodTemplatePod
        - `name` string, required
        - `node` PvcsPodNode
          - `name` string, required
      - `state` 'Running' | 'Terminating' | 'Paused' | 'Pending' | 'Error' | 'Unknown', required
      - `stateMessage` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity. Validation error.
- `500` — Internal server error

## Changes

- **2026-04-09** `e9c6319e31be` — 1 info
  - endpoint added
- **2026-01-30** `e4dc5b696346` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/opendatahub-io/apis/kubeflow-notebooks-api/changes/persistentvolumeclaims/:namespace/get.md)

---

[API](https://skmtc.dev/opendatahub-io/apis/kubeflow-notebooks-api.md) · [All operations](https://skmtc.dev/opendatahub-io/apis/kubeflow-notebooks-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opendatahub-io/kubeflow-notebooks-api/revisions/97fe86faf733/schema)