Billing, payment, and GPU usage on Ornn

​

How you pay

• Ornn credits: your organization’s credit balance. Proceeds from capacity you relist are added here, Ornn may also add or remove courtesy credit, and credits pay for your spot hours first.
• Saved card: charged automatically for spot hours that credits do not cover.

​

Save a card

​

Spot hours

​

Market purchases

​

Reservations

​

Invoices in Billing

• Billing overview: your open balance and paid invoice totals for this month and last month, shown separately by currency, and your available Ornn credits. Monthly totals use the invoice service period, or the payment date when there is no service period; draft and void invoices are excluded.
• Payment & invoicing: payment method information.
• Saved card: add or replace the card charged for spot hours.
• Overdue: a highlighted section that appears only when one or more open invoices are past their due date.
• Recent invoices: your latest invoices with date, kind (down payment, period invoice, or prepayment for a wire-paid Market purchase), amount, and status, plus actions to pay or download.
• History: per-reservation GPU-hours and usage cost for the part of each reservation that falls in the dates you choose, using your reserved GPU count and agreed price. Spot usage starts when the VM is ready and ends when the reservation stops; startup and cleanup time do not count, and a VM that never becomes ready has no usage. Reserved windows count whether or not you launch a VM; cancelled reservations have no usage. This is informational, not a new charge.

​

Invoice statuses

​

Paying an invoice

• Pay now: open invoices. Opens the Stripe-hosted invoice page.
• Pay overdue: open invoices past their due date.
• Download: when a PDF copy is available.

​

GPU usage

​

Paying an invoice

• Pay now: shown for open invoices. Opens the Stripe-hosted invoice page.
• Pay overdue: shown for open invoices past their due date. Opens the Stripe-hosted invoice page.
• Download: shown when a PDF copy is available.

​

Read billing through the API

ornn reservations invoices --reservation-id <reservation-id> --format json

export ORNN_API_URL='https://api.ornn.com'

curl --fail-with-body "$ORNN_API_URL/commerce/invoices?limit=100" \
  -H "Authorization: Bearer $ORNN_API_KEY" \
  | jq -r '.invoices[] | "\(.createdAt)\t\(.type)\t\(.status)\t\(.amountCents)\t\(.currency)"'

curl --fail-with-body \
  "$ORNN_API_URL/commerce/billing/showback?start=2026-10-01&end=2026-10-14" \
  -H "Authorization: Bearer $ORNN_API_KEY"

curl --fail-with-body "$ORNN_API_URL/v1/ledger/accounts" \
  -H "Authorization: Bearer $ORNN_API_KEY" \
  | jq '[.accounts[] | select(.account.account_role == "ORNN_CREDIT" and .account.currency == "usd")
         | .balance_cents | tonumber] | add // 0 | 0 - . | if . < 0 then 0 else . end'

import os

import requests

API = "https://api.ornn.com"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['ORNN_API_KEY']}"

invoices, cursor = [], None
while True:
    params = {"limit": 100, **({"cursor": cursor} if cursor else {})}
    page = session.get(f"{API}/commerce/invoices", params=params, timeout=30)
    page.raise_for_status()
    body = page.json()
    invoices.extend(body["invoices"])
    cursor = body.get("nextCursor")
    if not cursor:
        break
unpaid = [i for i in invoices if i["status"] == "open"]
print(f"{len(unpaid)} open invoices")

accounts = session.get(f"{API}/v1/ledger/accounts", timeout=30)
accounts.raise_for_status()
credit_cents = max(
    0,
    -sum(
        int(row["balance_cents"])
        for row in accounts.json()["accounts"]
        if row["account"]["account_role"] == "ORNN_CREDIT" and row["account"]["currency"] == "usd"
    ),
)
print(f"Ornn credits: ${credit_cents / 100:,.2f}")

​

What’s next

Spot

Rent VMs with 1, 2, 4, or 8 GPUs by the hour.

Nodes

Find a reservation’s detail page and its utilization.