---
title: "Your rentals, GPU-hours, USD billed and fault closes, grouped (resellers only)"
method: GET
path: "/partners/me/rentals"
tags: ["Support API Key Authentication"]
---

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

`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`

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`).

## Query parameters

- `since` string, 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`.
- `until` string, 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 `200`

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

- ResellerReportResponse
  - `since` string, date, required: First UTC day of the window, inclusive.
  - `until` string, date, required: Last UTC day of the window, inclusive.
  - `group_by` 'day' | 'gpu' | 'customer_ref', required
  - `rows` ResellerReportRow[], required
    - `bucket` string, required: The group: a UTC day (YYYY-MM-DD), a GPU model (`volume` for storage charges), or a customer_ref (`untagged` for rentals without one).
    - `rentals` integer, required: Rentals opened in the window and this bucket, failed starts included.
    - `gpu_hours` number, required: Sum of rental hours × GPU count; a rental still running is counted to now.
    - `usd_billed` number, required: Sum of the account's billing rows (billing_day in the window) in this bucket.
    - `fault_closes` integer, required: Rentals closed by a provider or platform fault (executor offline, broken by provider, rent failed, undeploy failed).

## Other responses

- `401`: No session and no valid API key
- `403`: The account is not a reseller, or the API key lacks the read scope
- `422`: `until` before `since`, a window over 366 days, or an unreadable date

## Changes

- **2026-10-09** `2f9d89f2cb43`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lium/apis/lium-backend-api/changes/partners/me/rentals/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)