---
title: "List Persistent Volume Claims For All Namespaces"
method: GET
path: "/api/v1/persistentvolumeclaims"
tags: ["Volumes"]
---

# List Persistent Volume Claims For All Namespaces

`GET /api/v1/persistentvolumeclaims`

## Request

- The document declares no server URL.
- Auth: none declared

Get a list of all PersistentVolumeClaim objects.

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

## Changes

- **2025-03-06** `272d90638842`: 3 warning
  - added the new `FromStorageProfile` enum value to the `items/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaim]/spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `200` (media type: application/json)
  - added the new `FromStorageProfile` enum value to the `items/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaim]/spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `200` (media type: application/json;stream=watch)
  - added the new `FromStorageProfile` enum value to the `items/items/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaim]/spec/allOf[#/components/schemas/k8s.io.v1.PersistentVolumeClaimSpec]/volumeMode` response property for the response status `200` (media type: application/yaml)
- …earlier changes not shown

[Operation history](https://skmtc.dev/harvester/apis/harvester-apis/changes/api/v1/persistentvolumeclaims/get.md)

---

[API](https://skmtc.dev/harvester/apis/harvester-apis.md) - [All operations](https://skmtc.dev/harvester/apis/harvester-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/harvester/apis/harvester-apis/revisions/809603752878?raw)