Skip to main content
GET
Get usage

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <credential> to https://customer-api.mountthor.com. People use the session that mthr login stores (a token starting mt_session_, valid for up to 12 hours). Automation uses a service-account credential (starting mt_sa_v1_, valid for 90 days) from Create credential. Each operation names the permission it needs. Service accounts hold permissions through custom roles, and some operations refuse them; those operations say so.

Query Parameters

period
string
required

24h, 7d, month (the current calendar month), or a past month as YYYY-MM.

Response

OK

period_start
string<date-time>

Start of the period covered (inclusive). The period ends at period_end, never later than now.

period_end
string<date-time>
requested
string

The canonicalized requested period (24h, 7d, month, or YYYY-MM).

bucket
string

Bucket grain of buckets: hour or day.

summary
object[]

Window totals per meter, meter-ordered.

buckets
object[]

The time series, oldest first. Buckets with no usage AND no spend are omitted.

spend
object

Actual charges in the period: every paid compute window that started in it. A window's whole amount counts in the bucket where it started.

spend_items
object[]

Window-level itemization of spend, ordered by (resource_kind, resource_class). The per-bucket breakdowns are on each UsageBucket.

pending_holds
object

Funds set aside for compute windows that have started but are not final, across all time rather than just this period. They are already deducted from your available funds.