> ## 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.

# Track GPU usage and invoices on Ornn

> Monitor GPU-hour consumption on the reservation detail page, and review and pay Stripe-hosted invoices from Account → Billing.

Ornn surfaces GPU utilization on each reservation when telemetry is available, and issues invoices through Stripe. You can check usage from the reservation detail page and review or pay invoices from **Account → Billing**.

## Viewing GPU usage

Usage data for a reservation is shown on its detail page (`/portfolio/[reservationId]`) when telemetry from the underlying hardware has been received. The panel is labeled **Utilization** and shows a progress bar whose value reads `<used>/<total> GPU hours` (for example, `120/960 GPU hours`), where the total is derived from GPU count and term length. A secondary line below the value shows the recent-jobs synced count and a staleness figure.

<Note>
  If telemetry hasn't been received yet, the utilization value shows a dash and the panel reads **Usage reporting is not available yet for this reservation.** This can appear before the first workload runs or briefly between syncs.
</Note>

### Recent jobs

When usage data is available, the utilization panel shows a recent-jobs synced count alongside the GPU-hour figure, with text like "12 recent jobs synced · 45s stale". The detail page does not render per-job rows. If usage data hasn't synced yet, no count appears.

The usage response still carries per-job details for scripted use; see the **Raw fields (advanced)** section below.

### Raw fields (advanced)

For scripted use, the usage response exposes these fields:

| Field                 | Type    | Description                                                        |
| --------------------- | ------- | ------------------------------------------------------------------ |
| `used_gpu_hours`      | number  | Total GPU-hours consumed so far.                                   |
| `remaining_gpu_hours` | number  | GPU-hours still available within the allocated total.              |
| `allocated_gpu_hours` | number  | Total GPU-hours allocated for the term.                            |
| `staleness_secs`      | integer | Seconds since the last usage sync. `null` if no sync has occurred. |

Each job entry exposes: `job_id`, `account`, `user`, `state`, `gpu_count`, `duration_secs`, `gpu_hours`, `start_time`, `end_time`.

## Invoices in Account → Billing

The **Billing** tab on the Account page is the source of truth for billing activity on your tenant. It includes:

* **Billing overview**: your current balance and any amount due.
* **Payment & invoicing**: your payment method and the email address invoices are sent to.
* **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, amount, and status, plus actions to pay or download.

<Note>
  Invoice delivery email and billing details are not editable from Account → Billing in the current release. To update them, use the **Support** link in the Billing tab.
</Note>

### Invoice statuses

Ornn surfaces the following invoice statuses from Stripe:

| Status            | Meaning                                                    |
| ----------------- | ---------------------------------------------------------- |
| **Draft**         | The invoice is being prepared and has not been issued yet. |
| **Open**          | The invoice has been issued and payment is expected.       |
| **Paid**          | Payment has been received and the invoice is settled.      |
| **Void**          | The invoice was voided and does not require payment.       |
| **Uncollectible** | Payment is no longer expected to be collected.             |

**Overdue** is not a separate Stripe status; it's derived from an **Open** invoice whose due date has passed. Overdue invoices are highlighted in the Billing tab.

### Invoice fields (advanced)

| Field                | Type    | Description                                                               |
| -------------------- | ------- | ------------------------------------------------------------------------- |
| `amount_cents`       | integer | Amount in the smallest unit of the currency (for example, cents for USD). |
| `currency`           | string  | ISO currency code (for example, `usd`).                                   |
| `status`             | string  | One of the statuses above.                                                |
| `due_date`           | date    | Payment due date. `null` if no fixed due date.                            |
| `hosted_invoice_url` | string  | Link to the Stripe-hosted invoice and payment page.                       |
| `invoice_pdf_url`    | string  | Direct link to the invoice PDF, when available.                           |

## Paying an invoice

Recent invoice rows in Account → Billing expose actions based on the invoice state and whether the underlying URLs are available:

* **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.

All payments happen on the Stripe-hosted invoice page; the link from each row is the source of truth for payment status.

<Note>
  Only organization admins can pay invoices and use billing actions. Members can view the Billing tab but cannot launch payment.
</Note>

<Tip>
  Check the Stripe-hosted invoice page for the full list of accepted payment methods on your invoice.
</Tip>

## What's next

<CardGroup cols={2}>
  <Card title="Portfolio overview" img="https://mintcdn.com/ornn/fNQRwmmR9H-yzza5/images/banners/portfolio.jpg?fit=max&auto=format&n=fNQRwmmR9H-yzza5&q=85&s=f8319c8193ef1d8a2fd406d1c8235280" href="/guides/portfolio-overview" width="1200" height="800" data-path="images/banners/portfolio.jpg">
    Find the reservation detail page and the utilization bar.
  </Card>

  <Card title="Account settings" img="https://mintcdn.com/ornn/fNQRwmmR9H-yzza5/images/banners/account-settings.jpg?fit=max&auto=format&n=fNQRwmmR9H-yzza5&q=85&s=b3113ad57cc544064507c9f6e220dffd" href="/guides/account-settings" width="1200" height="800" data-path="images/banners/account-settings.jpg">
    Open the Billing tab and review your tenant's billing state.
  </Card>
</CardGroup>
