# Get org usage

`GET https://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 |  |

## Response 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 |  |

## Response 403

Default Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | `string` | yes |  |