---
title: "Get Pods"
method: GET
path: "/api/v1/pods/"
tags: ["Pods"]
---

# Get Pods

`GET /api/v1/pods/`

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Successful Response

- GenericPaginationResponseListAPIPodConfig
  - `total_count` integer — Total number of items available in the dataset
  - `offset` integer — Number of items to skip before starting to collect the result set
  - `limit` integer — Maximum number of items to return
  - `data` APIPodConfig[], required
    - `id` string — Unique identifier for the pod, generated as a UUID.
    - `userId` string, required — ID of the user associated with this pod, if applicable.
    - `teamId` string, nullable — ID of the team owning this pod, if applicable.
    - `walletId` string, nullable — ID of the wallet associated with this pod for billing or resource tracking.
    - `name` string, required — Name of the pod.
    - `type` 'HOSTED' | 'EXTERNAL'
    - `providerType` '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' | 'denvr', required
    - `status` 'PROVISIONING' | 'PENDING' | 'ACTIVE' | 'STOPPED' | 'ERROR' | 'DELETING' | 'UNKNOWN' | 'TERMINATED'
    - `installationStatus` 'PENDING' | 'ACTIVE' | 'FINISHED' | 'ERROR' | 'TERMINATED'
    - `installationFailure` string, nullable — Details about any installation failures that occurred, if applicable.
    - `installationProgress` integer, nullable — 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, nullable — Timestamp when the pod was terminated.
    - `gpuName` 'CPU_NODE' | 'A10_24GB' | 'A100_80GB' | 'A100_40GB' | 'A30_24GB' | 'A40_48GB' | 'B200_180GB' | 'B300_262GB' | 'GB200' | 'GB300' | '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', required
    - `gpuCount` integer, required — Number of GPUs allocated to the node.
    - `socket` 'PCIe' | 'SXM2' | 'SXM3' | 'SXM4' | 'SXM5' | 'SXM6', required
    - `priceHr` number, required — Hourly price for running the pod.
    - `stoppedPriceHr` number, nullable — Hourly price when the pod is stopped. If empty then `priceHr` is used.
    - `provisioningPriceHr` number, nullable — Hourly price during the provisioning process. If empty then `priceHr` is used.
    - `environmentType` 'ubuntu_22_cuda_12' | 'ubuntu_26' | '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, nullable — ID of the custom template applied to the pod, if applicable.
    - `clusterId` string, nullable — ID of the cluster to which the pod belongs.
    - `primePortMapping` PortMapping[], nullable — Port mapping.
      - `internal` string, required
      - `external` string, required
      - `protocol` 'TCP' | 'UDP', required
      - `usedBy` 'SSH' | 'JUPYTER_NOTEBOOK' | 'WEB_SERVER'
      - `description` string, nullable
    - `sshConnection` union — SSH connection/connections details.
      - string
      - string[]
    - `ip` union — IP address/addresses of the instance.
      - string
      - string[]
    - `resources` InstanceResources
      - `memory` integer, nullable — RAM available (in GB)
      - `disk` integer, nullable — Total disk space (in GB)
      - `shared_disk` integer, nullable — Total external shared disk space (in GB)
      - `vcpus` integer, nullable — vCPUs available
    - `attachedResources` AttachedResources[], nullable — Instance attached resources.
      - `resourceType` 'DISK', required
      - `id` union, required — Unique identifier for the resource.
        - string
        - integer
      - `status` 'UNATTACHED' | 'ATTACHED' | 'MOUNTED'
      - `isDetachable` boolean — Whether the resource is detachable.
      - `mountPath` string — Path to the mount point.
      - `resourcePath` string, nullable — Path to the resource.
      - `size` union — Size of the resource.
        - string
        - integer
      - `isShared` boolean, nullable — Whether the resource is shared.
    - `isSpot` boolean, nullable — Whether the instance is spot.
    - `autoRestart` boolean, nullable — Automatically restart the instance.
  - `status` string, nullable — Response status

## Other responses

- `401` — Authorization failed
- `422` — Invalid request data

---

[API](https://skmtc.net/primeintellect/apis/pi-api.md) · [All operations](https://skmtc.net/primeintellect/apis/pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primeintellect/pi-api/revisions/3d3868828a78/schema)