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

# Get Pods Status

`GET /api/v1/pods/status`

## Query parameters

- `pod_ids` string[] — List of pod ids

## Response `200`

Successful Response

- GenericResponseListAPIPodStatusResponse
  - `data` APIPodStatusResponse[], nullable — Response data
    - `podId` string, required — Unique identifier for the pod.
    - `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', required
    - `sshConnection` union — SSH connection details for the pod, which may be a string or list of strings (if there are multiple nodes).
      - string
      - string[]
    - `ip` union — IP address or list (if there are multiple nodes) of IP addresses associated with the pod.
      - string
      - string[]
    - `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 that has been completed, if available.
  - `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)