---
title: "Gets the total amount the organization currently owes, broken down by unpaid invoices and
 periods awaiting an invoice."
method: GET
path: "/billing/outstanding"
tags: ["Billing"]
---

# Gets the total amount the organization currently owes, broken down by unpaid invoices and
 periods awaiting an invoice.

`GET /billing/outstanding`

The total covers finalized-but-unpaid invoices plus the settled amount of ended periods not
 yet invoiced; the current, still-accruing period is reported separately and is not part of
 the total. The awaiting-invoice figure comes from settlement snapshots and may move while
 settlementStale is set.

## Query parameters

- `organizationId` string

## Response `200`

OK

- GetOutstandingCostEndpointOutput
  - `totalOutstanding` number, double, required — The total the organization currently owes: unpaid invoices plus periods awaiting an invoice. Excludes the current, still-accruing period.
  - `unpaidInvoicesAmount` number, double, required — The amount owed on finalized invoices that have not been paid.
  - `unpaidInvoiceCount` integer, required — How many unpaid invoices make up UnpaidInvoicesAmount.
  - `awaitingInvoiceAmount` number, double, required — The settled amount of ended periods that have not been invoiced yet.
  - `awaitingInvoicePeriodCount` integer, required — How many periods make up AwaitingInvoiceAmount.
  - `currentPeriodAccrued` number, double, required — Billable spend accrued in the current, still-open period. Not part of TotalOutstanding: nothing is due until the period ends and settles.
  - `currency` string, nullable — The currency the amounts are denominated in, or null when nothing is outstanding.
  - `settlementStale` boolean, required — Whether any period behind AwaitingInvoiceAmount is awaiting a settlement recompute, so that figure may still change.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.dev/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/revisions/4ee3e6f5e4f4/schema)