GET
/
pods
curl --request GET \
  --url https://rest.runpod.io/v1/pods \
  --header 'Authorization: Bearer <token>'
[
  {
    "adjustedCostPerHr": 0.69,
    "aiApiId": null,
    "consumerUserId": "user_2PyTJrLzeuwfZilRZ7JhCQDuSqo",
    "containerDiskInGb": 50,
    "containerRegistryAuthId": "clzdaifot0001l90809257ynb",
    "costPerHr": "0.74",
    "cpuFlavorId": "cpu3c",
    "desiredStatus": "RUNNING",
    "dockerEntrypoint": [
      "<string>"
    ],
    "dockerStartCmd": [
      "<string>"
    ],
    "endpointId": null,
    "env": {
      "ENV_VAR": "value"
    },
    "gpu": {
      "id": "<string>",
      "count": 1,
      "displayName": "<string>",
      "securePrice": 123,
      "communityPrice": 123,
      "oneMonthPrice": 123,
      "threeMonthPrice": 123,
      "sixMonthPrice": 123,
      "oneWeekPrice": 123,
      "communitySpotPrice": 123,
      "secureSpotPrice": 123
    },
    "id": "xedezhzb9la3ye",
    "image": "runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04",
    "interruptible": false,
    "lastStartedAt": "2024-07-12T19:14:40.144Z",
    "lastStatusChange": "Rented by User: Fri Jul 12 2024 15:14:40 GMT-0400 (Eastern Daylight Time)",
    "locked": false,
    "machine": {
      "minPodGpuCount": 123,
      "gpuTypeId": "<string>",
      "gpuType": {
        "id": "<string>",
        "count": 1,
        "displayName": "<string>",
        "securePrice": 123,
        "communityPrice": 123,
        "oneMonthPrice": 123,
        "threeMonthPrice": 123,
        "sixMonthPrice": 123,
        "oneWeekPrice": 123,
        "communitySpotPrice": 123,
        "secureSpotPrice": 123
      },
      "cpuCount": 123,
      "cpuTypeId": "<string>",
      "cpuType": {
        "id": "<string>",
        "displayName": "<string>",
        "cores": 123,
        "threadsPerCore": 123,
        "groupId": "<string>"
      },
      "location": "<string>",
      "dataCenterId": "<string>",
      "diskThroughputMBps": 123,
      "maxDownloadSpeedMbps": 123,
      "maxUploadSpeedMbps": 123,
      "supportPublicIp": true,
      "secureCloud": true,
      "maintenanceStart": "<string>",
      "maintenanceEnd": "<string>",
      "maintenanceNote": "<string>",
      "note": "<string>",
      "costPerHr": 123,
      "currentPricePerGpu": 123,
      "gpuAvailable": 123,
      "gpuDisplayName": "<string>"
    },
    "machineId": "s194cr8pls2z",
    "memoryInGb": 62,
    "name": "<string>",
    "networkVolume": {
      "id": "agv6w2qcg7",
      "name": "my network volume",
      "size": 50,
      "dataCenterId": "EU-RO-1"
    },
    "portMappings": {
      "22": 10341
    },
    "ports": [
      "8888/http",
      "22/tcp"
    ],
    "publicIp": "100.65.0.119",
    "savingsPlans": [
      {
        "costPerHr": 0.21,
        "endTime": "2024-07-12T19:14:40.144Z",
        "gpuTypeId": "NVIDIA GeForce RTX 4090",
        "id": "clkrb4qci0000mb09c7sualzo",
        "podId": "xedezhzb9la3ye",
        "startTime": "2024-05-12T19:14:40.144Z"
      }
    ],
    "slsVersion": 0,
    "templateId": null,
    "vcpuCount": 24,
    "volumeEncrypted": false,
    "volumeInGb": 20,
    "volumeMountPath": "/workspace"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
computeType
enum<string>

Filter to only GPU or only CPU Pods.

Available options:
GPU,
CPU
Example:

"CPU"

​
cpuFlavorId
string[]

Filter to CPU Pods with any of the listed CPU flavors.

Example:
["cpu3c", "cpu5g"]
​
dataCenterId
string[]

Filter to Pods located in any of the provided RunPod data centers.

Example:
["EU-RO-1"]
​
desiredStatus
enum<string>

Filter to Pods currently in the provided state.

Available options:
RUNNING,
EXITED,
TERMINATED
Example:

"RUNNING"

​
endpointId
string

Filter to workers on the provided Serverless endpoint (note that endpoint workers are not included in the response by default, set includeWorkers to true to include them).

Maximum length: 191
​
gpuTypeId
string[]

Filter to Pods with any of the listed GPU types attached.

Example:
[
  "NVIDIA GeForce RTX 4090",
  "NVIDIA RTX A5000"
]
​
id
string

Filter to a specific Pod.

Example:

"xedezhzb9la3ye"

​
imageName
string

Filter to Pods created with the provided image.

Example:

"runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04"

​
includeMachine
boolean
default:false

Include information about the machine the Pod is running on.

Example:

true

​
includeNetworkVolume
boolean
default:false

Include information about the network volume attached to the returned Pod, if any.

Example:

true

​
includeSavingsPlans
boolean
default:false

Include information about the savings plans applied to the Pod.

Example:

true

​
includeTemplate
boolean
default:false

Include information about the template the Pod uses, if any.

Example:

true

​
includeWorkers
boolean
default:false

Set to true to also list Pods which are Serverless workers.

Example:

true

​
name
string

Filter to Pods with the provided name.

Maximum length: 191
​
networkVolumeId
string

Filter to Pods with the provided network volume attached.

Example:

"agv6w2qcg7"

​
templateId
string

Filter to Pods created from the provided template.

Example:

"30zmvf89kd"

Response

200
application/json

Successful operation.

The response is of type object[].