UpCloud

Billing

Access billing summaries and resource billing details for your UpCloud account. The API user account must have permission to read billing details to access these endpoints.

GET/1.3/account/billing/summary/{yearmonth}

Get monthly billing summary

Returns billing summary with resource details, where yearmonth specifies the year and month in the form YYYY-MM (e.g., 2024-09).

URL parameters

  • Name
    resource_id
    Type
    string
    Description

    For IP addresses: the address itself. For other resources: resource UUID. If specified, only the details of the given resource are returned.

  • Name
    username
    Type
    string
    Description

    Retrieves the billing summary of given account instead of the calling account. Requires Partner API access.

Request

GET
/1.3/account/billing/summary/{yearmonth}
curl -X GET https://api.upcloud.com/1.3/account/billing/summary/2024-09 \
  -u your_username:your_password
GET/1.3/account/resource_billing_summary/{resource_id}/{yearmonth}

Get resource billing summary

Returns resource billing summary for a specific resource.

Path parameters

  • Name
    resource_id
    Type
    string
    Description

    Server UUID, storage UUID, or IP address. Required.

  • Name
    yearmonth
    Type
    string
    Description

    Specifies the year and month in the form YYYY-MM (e.g., 2019-12). Required.

Request

GET
/1.3/account/resource_billing_summary/{resource_id}/{yearmonth}
curl -X GET https://api.upcloud.com/1.3/account/resource_billing_summary/00ce9363-9065-4c2a-9d66-3b0c762f556b/2019-12 \
  -u your_username:your_password