account

Get network transfer statistics

Returns network transfer statistics. JSON responses support a maximum time window of 31 days; CSV responses have no time-window limit. Select the output format with the Accept header using application/json or text/csv.

get/1.3/account/network_usage

Request

  • Base URL: https://api.upcloud.com
  • URL: https://api.upcloud.com/1.3/account/network_usage
  • Auth: HTTP bearer

Query parameters

fromstring date-time required

Datetime in RFC 3339 format

Example:2026-07-01T00:00:00Z

First measurement timestamp in RFC 3339 format.

tostring date-time required

Datetime in RFC 3339 format

Example:2026-07-01T00:00:00Z

Last measurement timestamp in RFC 3339 format.

accumulate'hour' | 'day'

Usage accumulator hour or day parameter

Accumulate the transfer statistics by hour or day.

Response

Account network usage statistics.

Example response

{
  "stats": {
    "stat": [
      {
        "accumulated_quota_bytes": 6352371508013,
        "projected_monthly_quota_bytes": 6362243967561,
        "quota_increase_bytes": 9872459548,
        "sent_bytes": 1254,
        "start_time": "2020-09-30T22:00:00Z",
        "total_sent_bytes": 225149331390
      },
      {
        "accumulated_quota_bytes": 6362243967561,
        "projected_monthly_quota_bytes": 6362243967561,
        "quota_increase_bytes": 9872459548,
        "sent_bytes": 1254,
        "start_time": "2020-09-30T23:00:00Z",
        "total_sent_bytes": 225149332644
      },
      {
        "accumulated_quota_bytes": 9872459548,
        "projected_monthly_quota_bytes": 7345109903712,
        "quota_increase_bytes": 9872459548,
        "sent_bytes": 906,
        "start_time": "2020-10-01T00:00:00Z",
        "total_sent_bytes": 906
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.