---
title: "List Namespaced Persistent Volume Claims"
method: GET
path: "/api/v1/namespaces/{namespace}/persistentvolumeclaims"
tags: ["Volumes"]
---

# List Namespaced Persistent Volume Claims

`GET /api/v1/namespaces/{namespace}/persistentvolumeclaims`

Get a list of PersistentVolumeClaim objects in a namespace.

## Query parameters

- `continue` string
- `fieldSelector` string
- `includeUninitialized` boolean
- `labelSelector` string
- `limit` integer
- `resourceVersion` string
- `timeoutSeconds` integer
- `watch` boolean

## Response `200`

OK

- K8sIoV1PersistentVolumeClaimList
  - `apiVersion` string, required
  - `items` K8sIoV1PersistentVolumeClaim[], required
    - `apiVersion` string, required
    - `kind` string, required
    - `metadata` K8sIoV1ObjectMeta
      - `name` string, required
      - `namespace` string
    - `spec` K8sIoV1PersistentVolumeClaimSpec
      - `accessModes` string[]
      - `dataSource` K8sIoV1TypedLocalObjectReference
        - `apiGroup` string
        - `kind` string, required
        - `name` string, required
      - `dataSourceRef` K8sIoV1TypedObjectReference
        - `apiGroup` string
        - `kind` string, required
        - `name` string, required
        - `namespace` string
      - `resources` K8sIoV1VolumeResourceRequirements
        - `limits` object
        - `requests` object
      - `selector` K8sIoV1LabelSelector
        - `matchExpressions` K8sIoV1LabelSelectorRequirement[]
          - `key` string, required
          - `operator` string, required
          - `values` string[]
        - `matchLabels` object
      - `storageClassName` string
      - `volumeAttributesClassName` string
      - `volumeMode` 'Block' | 'Filesystem' | 'FromStorageProfile'
      - `volumeName` string
    - `status` K8sIoV1PersistentVolumeClaimStatus
      - `accessModes` string[]
      - `allocatedResourceStatuses` object
      - `allocatedResources` object
      - `capacity` object
      - `conditions` K8sIoV1PersistentVolumeClaimCondition[]
        - `lastProbeTime` string
        - `lastTransitionTime` string
        - `message` string
        - `reason` string
        - `status` string, required
        - `type` string, required
      - `currentVolumeAttributesClassName` string
      - `modifyVolumeStatus` K8sIoV1ModifyVolumeStatus
        - `status` 'InProgress' | 'Infeasible' | 'Pending', required
        - `targetVolumeAttributesClassName` string
      - `phase` 'Bound' | 'Lost' | 'Pending'
  - `kind` string, required
  - `metadata` K8sIoV1ListMeta
    - `continue` string
    - `remainingItemCount` integer
    - `resourceVersion` string
    - `selfLink` string

## Other responses

- `401` — Unauthorized

---

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