Skip to main content
GET
/
api
/
v1
/
pods
/
{pod_id}
Get Pod
curl --request GET \
  --url https://api.primeintellect.ai/api/v1/pods/{pod_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "userId": "<string>",
  "teamId": "<string>",
  "walletId": "<string>",
  "name": "<string>",
  "type": "HOSTED",
  "providerType": "runpod",
  "status": "PROVISIONING",
  "installationStatus": "PENDING",
  "installationFailure": "<string>",
  "installationProgress": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "terminatedAt": "2023-11-07T05:31:56Z",
  "gpuName": "CPU_NODE",
  "gpuCount": 1,
  "socket": "PCIe",
  "priceHr": 1.23,
  "stoppedPriceHr": 0.005,
  "provisioningPriceHr": 123,
  "environmentType": "ubuntu_22_cuda_12",
  "customTemplateId": "<string>",
  "clusterId": "<string>",
  "primePortMapping": [
    {
      "internal": "8080",
      "external": "1234",
      "protocol": "TCP",
      "usedBy": "SSH",
      "description": "<string>"
    }
  ],
  "sshConnection": "<string>",
  "ip": "<string>",
  "resources": {
    "memory": "128",
    "disk": "1000",
    "shared_disk": "1000",
    "vcpus": "32"
  },
  "attachedResources": [
    {
      "resourceType": "DISK",
      "id": "<string>",
      "status": "UNATTACHED",
      "isDetachable": true,
      "mountPath": "/workspace",
      "resourcePath": "<string>",
      "size": "<string>",
      "isShared": true
    }
  ],
  "isSpot": true,
  "autoRestart": true
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
pod_id
string
required

Response

Successful Response

​
userId
string
required

ID of the user associated with this pod, if applicable.

​
name
string
required

Name of the pod.

​
providerType
enum<string>
required

Type of provider associated with the pod, based on ProviderTypeEnum.

Available options:
runpod,
fluidstack,
lambdalabs,
hyperstack,
oblivus,
cudocompute,
scaleway,
tensordock,
datacrunch,
latitude,
crusoecloud,
massedcompute,
akash,
primeintellect,
primecompute,
dc_impala,
dc_kudu,
dc_roan,
nebius,
dc_eland,
dc_wildebeest,
vultr,
dc_gnu
​
gpuName
enum<string>
required

Model of the GPU allocated.

Available options:
CPU_NODE,
A10_24GB,
A100_80GB,
A100_40GB,
A30_24GB,
A40_48GB,
B200_180GB,
RTX3070_8GB,
RTX3070_8GB,
RTX3080_10GB,
RTX3080Ti_12GB,
RTX3090_24GB,
RTX3090Ti_24GB,
RTX4070Ti_12GB,
RTX4080_16GB,
RTX4080Ti_16GB,
RTX4090_24GB,
RTX5090_32GB,
H100_80GB,
H200_96GB,
GH200_96GB,
H200_141GB,
GH200_480GB,
GH200_624GB,
L4_24GB,
L40_48GB,
L40S_48GB,
RTX4000_8GB,
RTX5000_16GB,
RTX6000_24GB,
RTX8000_48GB,
RTX2000Ada_16GB,
RTX4000Ada_20GB,
RTX5000Ada_32GB,
RTX6000Ada_48GB,
A2000_6GB,
A4000_16GB,
A4500_20GB,
A5000_24GB,
A6000_48GB,
V100_16GB,
V100_32GB,
P100_16GB,
T4_16GB,
P4_8GB,
P40_24GB,
RTX_PRO_6000B_96GB
​
gpuCount
integer
required

Number of GPUs allocated to the node.

Examples:

1

​
socket
enum<string>
required

Type of socket used by the GPU.

Available options:
PCIe,
SXM2,
SXM3,
SXM4,
SXM5,
SXM6
​
priceHr
number
required

Hourly price for running the pod.

Examples:

1.23

​
id
string

Unique identifier for the pod, generated as a UUID.

​
teamId
string | null

ID of the team owning this pod, if applicable.

​
walletId
string | null

ID of the wallet associated with this pod for billing or resource tracking.

​
type
enum<string>

Type of the pod, based on PodTypeEnum.

Available options:
HOSTED,
EXTERNAL
​
status
enum<string>

Current status of the pod, based on PodStatusEnum.

Available options:
PROVISIONING,
PENDING,
ACTIVE,
STOPPED,
ERROR,
DELETING,
UNKNOWN,
TERMINATED
​
installationStatus
enum<string>

Installation status of the pod, based on InstallationStatusEnum.

Available options:
PENDING,
ACTIVE,
FINISHED,
ERROR,
TERMINATED
​
installationFailure
string | null

Details about any installation failures that occurred, if applicable.

​
installationProgress
integer | null

Percentage of the installation process completed.

​
createdAt
string<date-time>

Timestamp when the pod was created.

​
updatedAt
string<date-time>

Timestamp when the pod was last updated.

​
terminatedAt
string<date-time> | null

Timestamp when the pod was terminated.

​
stoppedPriceHr
number | null

Hourly price when the pod is stopped. If empty then priceHr is used.

Examples:

0.005

​
provisioningPriceHr
number | null
default:0

Hourly price during the provisioning process. If empty then priceHr is used.

​
environmentType
enum<string>

Type of image selected for the pod.

Available options:
ubuntu_22_cuda_12,
cuda_12_1_pytorch_2_2,
cuda_11_8_pytorch_2_1,
cuda_12_1_pytorch_2_3,
cuda_12_1_pytorch_2_4,
cuda_12_4_pytorch_2_4,
cuda_12_4_pytorch_2_5,
cuda_12_4_pytorch_2_6,
cuda_12_6_pytorch_2_7,
stable_diffusion,
axolotl,
bittensor,
hivemind,
petals_llama,
vllm_llama_8b,
vllm_llama_70b,
vllm_llama_405b,
custom_template,
flux,
prime_rl
​
customTemplateId
string | null

ID of the custom template applied to the pod, if applicable.

​
clusterId
string | null

ID of the cluster to which the pod belongs.

​
primePortMapping
PortMapping · object[] | null

Port mapping.

​
sshConnection

SSH connection/connections details.

​
ip

IP address/addresses of the instance.

​
resources
object | null

Instance resources.

​
attachedResources
AttachedResources · object[] | null

Instance attached resources.

​
isSpot
boolean | null

Whether the instance is spot.

​
autoRestart
boolean | null

Automatically restart the instance.