Support API Key Authentication

Your rentals, GPU-hours, USD billed and fault closes, grouped (resellers only)

Changed on

Aggregates of the account's rentals — every key and workspace of the account, one balance — for a window of whole UTC days: rentals and gpu_hours and fault_closes from the rental records (a rental sits in the day it was opened), usd_billed from the billing ledger (the rows whose billing day is in the window, the same rows the statement shows). Grouped by day, GPU model or customer_ref. Only an account flagged as a reseller may call it; other accounts get 403. Cached for five minutes (private).

get/partners/me/rentals

Request

  • Base URL: https://lium.io/api
  • URL: https://lium.io/api/partners/me/rentals
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

sincestring date-time nullable

First UTC day of the window, inclusive: an ISO date (2026-09-01) or date-time (a time zone offset is honoured, then the UTC day is taken). Default: 30 days ending at until.

untilstring date-time nullable

Last UTC day of the window, inclusive, same forms as since. Default: today (UTC).

group_by'day' | 'gpu' | 'customer_ref'

day (one row per UTC day), gpu (one row per GPU model; volume for storage charges) or customer_ref (one row per end-customer tag; untagged for rentals without one).

Response

The rows for the window; Cache-Control: private, max-age=300

sincestring date required

First UTC day of the window, inclusive.

untilstring date required

Last UTC day of the window, inclusive.

group_by'day' | 'gpu' | 'customer_ref' required

Changes