Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ornn.com/llms.txt

Use this file to discover all available pages before exploring further.

Ornn tracks GPU utilization per reservation and issues invoices through Stripe as your term progresses. You can check how many GPU-hours you’ve used and how many remain directly from the reservation detail page, and you can view and pay invoices from your account settings.

Viewing GPU usage

Usage data for each reservation is available on the reservation detail page at /portfolio/[reservationId]. The utilization panel shows a progress bar along with the following values:
used_gpu_hours
number
Total GPU-hours consumed so far on this reservation.
remaining_gpu_hours
number
GPU-hours still available within your allocated total.
allocated_gpu_hours
number
Total GPU-hours allocated for the reservation term. This is calculated from the GPU count and the length of the reservation period.
staleness_secs
integer
How many seconds have elapsed since the last usage sync. A high value means the displayed figures may be out of date. null if no sync has occurred yet.
If the utilization bar shows “Not reported yet,” no usage telemetry has been received for this reservation. Data typically appears within a few minutes of the first job or workload starting.

Recent job history

The usage response also includes the last 25 jobs synced for the reservation. Each job entry contains:
job_id
string
The unique identifier for the job.
account
string
The compute account under which the job ran.
user
string
The username that submitted the job. May be null.
state
string
The final job state, for example COMPLETED, FAILED, or CANCELLED.
gpu_count
integer
The number of GPUs the job requested.
duration_secs
integer
How long the job ran, in seconds.
gpu_hours
number
GPU-hours consumed by this job, calculated from gpu_count × (duration_secs / 3600).
start_time
datetime
When the job started. May be null if not yet recorded.
end_time
datetime
When the job ended. May be null if the job has not completed.
The recent jobs count appears below the utilization bar on the reservation detail page — for example, “12 recent jobs synced.”

Invoices

Ornn issues invoices through Stripe. Your invoices appear in your account settings. Each invoice record includes:
amount_cents
integer
The invoice amount in the smallest unit of the invoice currency (for example, cents for USD).
currency
string
The currency code, for example usd.
status
string
The current invoice status. See the table below for possible values.
due_date
date
The date by which payment is due. May be null for invoices without a fixed due date.
hosted_invoice_url
string
A link to the Stripe-hosted invoice page where you can review the full breakdown and pay online.
invoice_pdf_url
string
A direct link to download the invoice as a PDF.

Invoice statuses

StatusMeaning
openThe invoice has been issued and payment is expected
paidPayment was received and the invoice is settled
overdueThe due date has passed without payment
voidThe invoice was voided and does not require payment

Paying an invoice

To pay an open or overdue invoice, click the hosted invoice URL link in your account settings. This opens the Stripe-hosted invoice page where you can enter payment details and complete the transaction.
Stripe supports most major credit and debit cards. Check the Stripe invoice page for the full list of accepted payment methods.

Invoice email

Invoices are sent to the invoice email address configured for your tenant. You can update this address in your account settings.
If no invoice email is set, invoices may be sent to the primary contact email on your tenant account. Update your invoice email in account settings to ensure billing communications reach the right inbox.

What’s next

Portfolio overview

View your active reservations, check connection details, and see the utilization bar.

View and manage your bids

Track submitted bids, view terms and status, and manage pending offers.