Get org usage
GEThttps://api.instacloud.com/orgs/{orgId}/usage
Token scope: account · org — read-only tokens allowed.
Org usage across the 5 billing dimensions + per-project breakdown over a window (default current cycle)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
from | query | integer | no | unix seconds (default current cycle start) |
to | query | integer | no | unix seconds (default current cycle end) |
orgId | path | string | yes |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
from | integer | no | |
to | integer | no | |
org | object | no | |
org.dimensions | object[] | no | |
org.dimensions.dimension | "ram" | "cpu" | "volume" | "storage" | "egress" | no | |
org.dimensions.quantity | number | no | |
org.dimensions.unit | string | no | |
org.dimensions.costUsd | number | no | quantity × unit price for this dimension in the window |
org.totalCostUsd | number | no | |
projects | object[] | no | |
projects.projectId | string | no | |
projects.name | string | no | |
projects.deletedAt | string | null | no | when the project was deleted — its usage history outlives it; null for a live project |
projects.dimensions | object[] | no | |
projects.dimensions.dimension | "ram" | "cpu" | "volume" | "storage" | "egress" | no | |
projects.dimensions.quantity | number | no | |
projects.dimensions.unit | string | no | |
projects.dimensions.costUsd | number | no | quantity × unit price for this dimension in the window |
projects.totalCostUsd | number | no |
403
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |