Skip to main content
GET
List capacity listings
CLI equivalent: ornn capacity-offers list --kind primary. See Reserve GPU capacity for the complete offer flow.

Authorizations

Authorization
string
header
required

Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.

Query Parameters

kind
enum<string>

primary for Reserve listings or secondary for relisted capacity.

Available options:
primary,
secondary,
on_demand
state
enum<string>

Filter by state.

Available options:
draft,
available,
held,
sold,
delisted
sourceReservationId
string<uuid>

Relists of a reservation your organization holds.

organizationId
string<uuid>

Your own organization ID, to list only listings your organization owns. Any other value returns 403.

ids
string

Comma-separated listing IDs, at most 200.

limit
integer

Page size from 1 to 100. Defaults to 50.

Required range: 1 <= x <= 100
cursor
string

The nextCursor from the previous page, unchanged.

Response

One page of listings.

listings
object[]
required
nextCursor
string

Pass unchanged as cursor for the next page. Absent on the last page.