USAGE
View your account's consumption and quota usage.
USAGE
GET /v1/usage returns your account's consumption for the current billing period.
Base: https://api.podyard.dev/v1
GET /v1/usage — Get usage metrics
Headers: Authorization: Bearer <key>.
Response 200:
{
"podHours": 12.5,
"storageGiB": 2.1,
"execCount": 847,
"snapshotCount": 3,
"concurrentPods": 2,
"maxConcurrentPods": 5,
"period": {
"start": "2026-01-01T00:00:00Z",
"end": "2026-01-31T23:59:59Z"
}
}| Field | Type | Description |
|---|---|---|
podHours | number | Cumulative pod-hours consumed this period |
storageGiB | number | Current storage usage in GiB |
execCount | number | Total exec calls this period |
snapshotCount | number | Active snapshot count |
concurrentPods | int | Currently running pods |
maxConcurrentPods | int | Plan's concurrent pod limit |
period | object | Billing period start/end (ISO-8601 UTC) |
Errors: 401 unauthorized (invalid or missing key).
[DECIDE] — The exact billing unit (pod-hours vs. flat monthly) is not yet settled.
podHoursis the primary metered unit in the current implementation.