> For the complete documentation index, see [llms.txt](https://docs.nebulablock.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nebulablock.com/api-reference/platform-api/list-workspaces/get-usage.md).

# Get Storage Usage

Read storage and transfer usage for a workspace over the last 24 hours, 7 days, and 30 days.

Return storage and transfer usage for a workspace, broken down over the last 24 hours, 7 days, and 30 days.

## HTTP Request

`GET` `{API_URL}/object-storage/usage-data`

where `API_URL = https://api.nebulablock.com/api/v1`.

## Query Parameters

| Parameter             | Requirement | Type      | Description                                                                 |
| --------------------- | ----------- | --------- | --------------------------------------------------------------------------- |
| `object_storage_name` | Required    | `string`  | The workspace to report on                                                  |
| `team_id`             | Optional    | `integer` | Act on a team's storage instead of your own. See [Teams](/account/teams.md) |

## Response Attributes

Unlike the other object storage endpoints, this one returns its payload directly rather than wrapping it in a `data` / `message` / `status` envelope.

#### storage\_name `string`

The workspace the report covers.

#### detail\_24h `list`

Hourly statistics for the last 24 hours. Each entry contains **hour** `string`, **traffic\_amount** `integer`, and **capacity\_amount** `integer`.

#### detail\_7d `list`

Daily statistics for the last 7 days. Each entry contains **date** `string`, **traffic\_amount** `integer`, and **capacity\_amount** `integer`.

#### detail\_30d `list`

Daily statistics for the last 30 days, in the same shape as `detail_7d`.

## Example

#### Request

```bash
curl -X GET '{API_URL}/object-storage/usage-data?object_storage_name=research-datasets' \
-H 'Authorization: Bearer {TOKEN}'
```

#### Response

```json
{
    "storage_name": "research-datasets",
    "detail_24h": [
        {"hour": "2026-08-24 11:00", "traffic_amount": 1048576, "capacity_amount": 45872349184}
    ],
    "detail_7d": [
        {"date": "2026-08-23", "traffic_amount": 20971520, "capacity_amount": 45872349184}
    ],
    "detail_30d": [
        {"date": "2026-08-01", "traffic_amount": 8388608, "capacity_amount": 41234567890}
    ]
}
```

## See also

* [Object Storage](/products/object-storage.md)
* [Billing](/api-reference/platform-api/get-credit-balance.md)