---
title: "Alternatives to a pending price raise"
method: GET
path: "/pods/{id}/price-change-alternatives"
tags: ["Support API Key Authentication"]
---

# Alternatives to a pending price raise

`GET /pods/{id}/price-change-alternatives`

## Request

- Base URL: `https://lium.io/api`
- URL: `https://lium.io/api/pods/{id}/price-change-alternatives`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

While the pod has a pending provider price raise (`pending_price`), up to three nodes from the public listing with the same GPU type that fit the pod's GPU count at or below what the pod pays now, cheapest first. A pod rented Secure is offered Secure nodes only; the pod's own node is never listed. `alternatives` is empty when there is no pending raise or no such node. Read-only: renting one is an ordinary new rental.

## Path parameters

- `id` string, uuid, required

## Response `200`

Alternatives, possibly none

- PriceChangeAlternatives: `GET /pods/{id}/price-change-alternatives`: the pod's pending raise and where the same GPUs cost no more.
  - `pod_id` string, uuid, required
  - `current_price` number, nullable
  - `pending_price` number, nullable
  - `alternatives` PriceChangeAlternative[]
    - `executor_id` string, uuid, required
    - `machine_name` string, required
    - `gpu_count` integer, required
    - `price_per_gpu` number, required
    - `hourly_price` number, required
    - `tier` string, nullable
    - `reliability_score` number, nullable
    - `country_code` string, nullable
    - `city` string, nullable

## Other responses

- `404`: Pod not found
- `422`: Validation Error

## Changes

- **2026-10-15** `0923ca5b0fc4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lium/apis/lium-backend-api/changes/pods/:id/price-change-alternatives/get.md)

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lium/apis/lium-backend-api/revisions/a682d3ef1e07?raw)