Skip to content
Updawg

`GET /v1/orgs/{org}/billing/usage` (DAWG-144).

GET
/v1/orgs/{org}/billing/usage
curl --request GET \
  --url https://api.updawg.net/v1/orgs/example/billing/usage

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Organization slug.

Query Parameters

Section titled “Query Parameters”
month
string

YYYY-MM, UTC. This month when absent.

Responses

Section titled “Responses”

200

Section titled “200”

Active hosts per day for the month.

Media typeapplication/json
object
days
required

Every day with a recorded count, oldest first. A day nothing checked in on has no row and costs nothing.

Array<object>
object
active_hosts
required

Hosts that checked in during the day, UTC: the day’s billable count.

integer format: int32
day
required
string format: date
reported
required

Sent to Stripe.

boolean
estimate_pence

host_days on this plan’s list price, in pence, for an organization with a live subscription. An estimate: Stripe’s invoice is the bill.

integer | null format: int64
from
required

The first and last day of the month asked about.

string format: date
host_days
required

The sum of days: what the month has used so far.

integer format: int64
to
required
string format: date
today_so_far

Hosts that have checked in today so far, not yet in days. Only for the current month.

integer | null format: int64
Examplegenerated
{
  "days": [
    {
      "active_hosts": 1,
      "day": "2026-04-15",
      "reported": true
    }
  ],
  "estimate_pence": 1,
  "from": "2026-04-15",
  "host_days": 1,
  "to": "2026-04-15",
  "today_so_far": 1
}

400

Section titled “400”

month is not YYYY-MM.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

401

Section titled “401”

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

403

Section titled “403”

Only an owner manages billing.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

404

Section titled “404”

No such organization, or not yours.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

429

Section titled “429”

Over the organization’s request limit. Retry-After says when to try again; RateLimit-Limit is the burst.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string
Examplegenerated
{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}