Get Object Storage usage statistics

Retrieve detailed usage statistics for your object storage, including storage size, object count, data transfer, and API calls. You can filter data by time period (7 or 30 days) and get a breakdown by storage bucket.

Object Storage Usage

Context

Used in the dashboard

/object-storage

Query Parameters

breakdown string · Example: bucket
period string · enum required · Example: 7d
30d
7d

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.buckets array<object> · Example: [{"name":"service-service-backups","sizeBytes":37154816,"numObjects":8,"bytesSent":0,"b...
data.buckets[].bytesReceived integer required · Example: 0
data.buckets[].bytesSent integer required · Example: 0
data.buckets[].name string required · Example: service-service-backups
data.buckets[].numObjects integer · Example: 8
data.buckets[].opsDelete integer · Example: 0
data.buckets[].opsGet integer · Example: 0
data.buckets[].opsList integer · Example: 0
data.buckets[].opsPut integer · Example: 0
data.buckets[].sizeBytes integer · Example: 37154816
data.period string · enum required · Example: 7d
30d
7d
data.timeSeries array<object> · Example: [{"time":"2026-02-10T00:00:00.000Z","sizeBytes":0,"numObjects":0,"bytesSent":0,"bytesRe...
data.timeSeries[].bytesReceived integer required · Example: 0
data.timeSeries[].bytesSent integer required · Example: 0
data.timeSeries[].numObjects integer required · Example: 0
data.timeSeries[].opsDelete integer · Example: 0
data.timeSeries[].opsGet integer · Example: 0
data.timeSeries[].opsList integer · Example: 0
data.timeSeries[].opsPut integer · Example: 0
data.timeSeries[].sizeBytes integer · Example: 0
data.timeSeries[].time string · Example: 2026-02-10T00:00:00.000Z
data.totals object
data.totals.bytesReceived integer required · Example: 0
data.totals.bytesSent integer required · Example: 0
data.totals.opsDelete integer required · Example: 0
data.totals.opsGet integer · Example: 0
data.totals.opsList integer · Example: 0
data.totals.opsPut integer · Example: 0
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/object-storage/usage
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/object-storage/usage?period=7d" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "period": "7d",
    "timeSeries": [
      {
        "time": "2026-02-10T00:00:00.000Z",
        "sizeBytes": 0,
        "numObjects": 0,
        "bytesSent": 0,
        "bytesReceived": 0,
        "opsGet": 0,
        "opsPut": 0,
        "opsDelete": 0,
        "opsList": 0
      },
      {
        "time": "2026-02-10T00:00:00.000Z",
        "sizeBytes": 0,
        "numObjects": 0,
        "bytesSent": 0,
        "bytesReceived": 0,
        "opsGet": 0,
        "opsPut": 0,
        "opsDelete": 0,
        "opsList": 0
      },
      {
        "time": "2026-02-10T00:00:00.000Z",
        "sizeBytes": 0,
        "numObjects": 0,
        "bytesSent": 0,
        "bytesReceived": 0,
        "opsGet": 0,
        "opsPut": 0,
        "opsDelete": 0,
        "opsList": 0
      }
    ],
    "totals": {
      "bytesSent": 0,
      "bytesReceived": 0,
      "opsGet": 0,
      "opsPut": 0,
      "opsDelete": 0,
      "opsList": 0
    }
  }
}