API Reference
- docs
- pods
- endpoints
- network volumes
- templates
- container registry auth
- billing
pods
Find a Pod by ID
Returns a single Pod.
GET
/
pods
/
{podId}
curl --request GET \
--url https://rest.runpod.io/v1/pods/{podId} \
--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
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
ID of Pod to return.
Query Parameters
Include information about the machine the Pod is running on.
Example:
true
Include information about the network volume attached to the returned Pod, if any.
Example:
true
Include information about the savings plans applied to the Pod.
Example:
true
Include information about the template the Pod uses, if any.
Example:
true
Set to true to also list Pods which are Serverless workers.
Example:
true
Response
200
application/json
Successful operation.
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://rest.runpod.io/v1/pods/{podId} \
--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"
}