Skip to content
Docs

Get Organization Daily Cost

GET/v1/organizations/{organization_id}/billing/cost

Get the organization’s total usage cost per UTC day over a date range (max 90 days), summing open and closed resources. One entry per day, oldest first. Defaults to the last 30 days.

Path ParametersExpand Collapse
organization_id: string
Query ParametersExpand Collapse
from: optional string

Inclusive start day, YYYY-MM-DD (UTC). Defaults to 30 days before to.

formatdate
to: optional string

Inclusive end day, YYYY-MM-DD (UTC). Defaults to today.

formatdate
ReturnsExpand Collapse
OrganizationDailyCost object { currency, days, from, to }

Daily usage cost over a date range: one entry per UTC day (zero on idle days), summing open and closed resources. Suitable for a daily cost bar chart.

currency: string

ISO 4217 currency code.

days: array of DailyCostPoint { cost, date }

One entry per UTC day in the range, oldest first.

cost: string

Arbitrary-precision decimal serialized as a string (e.g. “58.40”).

formatdecimal
date: string

UTC calendar day (YYYY-MM-DD).

from: string

Inclusive start of the range, as a UTC calendar day (YYYY-MM-DD).

to: string

Inclusive end of the range, as a UTC calendar day (YYYY-MM-DD).

Get Organization Daily Cost

curl https://api.nirvanalabs.io/v1/organizations/$ORGANIZATION_ID/billing/cost \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"
{
  "currency": "USD",
  "days": [
    {
      "cost": "-69125",
      "date": "2026-07-07"
    }
  ],
  "from": "2026-06-08",
  "to": "2026-07-08"
}
Returns Examples
{
  "currency": "USD",
  "days": [
    {
      "cost": "-69125",
      "date": "2026-07-07"
    }
  ],
  "from": "2026-06-08",
  "to": "2026-07-08"
}