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

# Get Pods History

`GET /api/v1/pods/history`

## Query parameters

- `sort_by` 'terminatedAt' | 'createdAt'
- `sort_order` 'asc' | 'desc'
- `offset` integer
- `limit` integer

## Response `200`

Successful Response

- GenericPaginationResponseListHistoryObj
  - `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` HistoryObj[], required
    - `id` string, required — Unique identifier for the record.
    - `name` string, required — Name assigned to the resource.
    - `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
    - `provisionedBy` string, nullable — Name of the user who provisioned the resource.
    - `type` 'Instance' | 'Cluster' | 'Disk' | 'Sandbox' | 'Inference' | 'Image' | 'Training', required
    - `createdAt` string, date-time, required — Timestamp when the resource was created.
    - `terminatedAt` string, date-time, nullable — Timestamp when the resource was terminated.
    - `gpuName` string, required — Model of the GPU used in the resource.
    - `gpuCount` integer, required — Number of GPUs allocated to the resource.
    - `socket` string, nullable — Type of socket used by the GPU, if applicable.
    - `priceHr` number, required — Price per hour for using the resource (average).
    - `userId` string, required — ID of the user who owns the resource.
    - `teamId` string, nullable — ID of the team to which the resource is assigned, if applicable.
    - `totalBilledPrice` number, required — Total amount billed for this resource.
  - `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/126e47974033/schema)
