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"
    }