account

Get resource transfer statistics

Returns network transfer statistics grouped by resource, service, and zone. 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/resource_network_usage

Request

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

Query parameters

fromstring date-time required

Datetime in RFC 3339 format

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

Data start timestamp in RFC 3339 format.

tostring date-time required

Datetime in RFC 3339 format

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

Data end timestamp in RFC 3339 format.

service'load_balancer_private' | 'load_balancer_private_vlan' | 'load_balancer_public' | 'network_gateway_private' | 'network_gateway_private_vlan' | 'network_gateway_public' | 'object_storage_v2_private' | 'object_storage_v2_public' | 'server_private' | 'server_private_vlan' | 'server_public'

Network usage type for resource

Limit results to a service type. Repeat the parameter to include multiple service types.

resource_idstring uuid

Universally unique identifier

Example:0414e0d7-4436-4037-9dd8-6eaf47dce599

Limit results to this resource UUID.

zonestring

Zone identifier

Example:fi-hel1

Limit results to a zone. Repeat the parameter to include multiple zones.

accumulate'hour' | 'day'

Usage accumulator hour or day parameter

Accumulate the transfer statistics by hour or day.

Response

Resource network usage statistics.

Example response

{
  "stats": {
    "stat": [
      {
        "resource_id": "00777436-a6f8-43af-9daf-89e8e6833a7a",
        "sent_bytes": 10094,
        "service": "server_public",
        "start_time": "2020-09-07T00:00:00Z",
        "zone": "de-fra1"
      },
      {
        "resource_id": "00777436-a6f8-43af-9daf-89e8e6833a7a",
        "sent_bytes": 35174050,
        "service": "server_public",
        "start_time": "2020-09-08T00:00:00Z",
        "zone": "de-fra1"
      },
      {
        "resource_id": "00777436-a6f8-43af-9daf-89e8e6833a7a",
        "sent_bytes": 32790622,
        "service": "server_public",
        "start_time": "2020-09-09T00:00:00Z",
        "zone": "de-fra1"
      }
    ]
  }
}

Changes

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