IONOS Cloud Billing API (3.6.0)

Overview

The Ionos Billing API is a REST API that can be used to retrieve information about resource usage and invoices. Please note that only Contract Holders can log in and retrieve data. Information on usage is provided without liability.

What's New?

The following features have been added to the Billing API:

Available Products.

IP Address, CPU Cores, RAM, NAT

Location MeterID Meter Description Unit
EU / US A01000 30d per static IP address 30 days
EU / US C01000 1h core AMD 1 hour
EU C010EU 1h core AMD - EU 1 hour
US C010US 1h core AMD - US 1 hour
EU / US C02000 1h core Intel Broadwell (+1 hyperthread core) 1 hour
EU / US C03000 1h core Intel Skylake (+1 hyperthread core) 1 hour
EU / US CW1000 1 MS core - per hour 1 hour
EU / US CW1000 1 MS core - per hour 1 hour
EU CW10EU 1 MS core - per hour EU 1 hour
US CW10US 1 MS core - per hour US 1 hour
EU / US R01000 1h per GB RAM 1G * 1 hour
EU R010EU 1h per GB RAM - EU 1G * 1 hour
US R010US 1h per GB RAM - US 1G * 1 hour
EU / US CWSQL1001 1h per 2 cores License MS SQL Standard 1hour
EU / US CWSQL2001 1h per 2 cores License MS SQL Enterprise 1hour
EU / US CWSQL3001 1h per 2 cores License MS SQL Web 1hour
EU / US NAT1000 1h per NAT 1 hour
EU / US NLB1000 1h of first 5 forwarding rules for network loadbalancer 1 hour
EU / US NLB1100 1h of additional forwarding rule for network loadbalancer 1 hour
EU / US ALB1000 1h of first 5 forwarding rules for application loadbalancer 1 hour
EU / US ALB1100 1h of additional forwarding rule for application loadbalancer 1 hour

Storage

Location MeterID Meter Description Unit
EU / US S01000 30d per 1 GB HDD Storage 1 GB * 30 days
EU / US S02000 30d per 1 GB SSD Storage Premium 1 GB * 30 days
EU / US S03000 30d per 1 GB HDD Snapshot 1 GB * 30 days
EU / US S05000 30d per 1 GB SSD Storage Standard 1 GB * 30 days

CUBEs

Location MeterID Meter Description Unit
EU / US CUBExxxx * 1h of IONOS cloud Cubes with a certain configuration 1 hour
EU / US CC1000 ** 1h Cubes core 1 hour
EU / US CR1000 ** 1h per GB Cubes RAM 1G * 1 hour
EU / US DAS1000 ** 30d per 1 GB Cubes Directly Attached Storage 1 GB * 30 days

*) Dynamically generated product item (e.g. CUBE1100, CUBE1200 etc.), it references to a certain CUBE template (VM preset with overprovisioning) **) Non-billable items, provided just for estimation the consuming

Backup Storage

Location MeterID Meter Description Unit
EU BU1100 30d per 1GB Backup Storage for Orphaned Backup 1 GB * 30 days
EU BU1200 30d per 1GB Backup Storage for Win. or Mac WS Backup 1 GB * 30 days
EU BU1300 30d per 1GB Backup Storage for Win. or Linux Server Backup 1 GB * 30 days
EU BU1400 30d per 1GB Backup Storage for Virtual Machine Backup 1 GB * 30 days
EU BU1500 30d per 1GB Backup Storage for Office365 1 GB * 30 days

S3 Object Storage

Location MeterID Meter Description Unit
EU S3AU1100 Count of PUT/COPY/POST/LOST S3 API request per 1,000 calls 1,000 calls
EU S3AU1200 Count of GET S3 API request per 10,000 calls 10,000 calls
EU S3AU1300 Count of DELETE S3 API request per 10,000 calls 10,000 calls
EU S3SU1100 30d per 1 GB S3 Object Storage for first 50 TB 1 GB x 30 days
EU S3SU1200 30d per 1 GB S3 Object Storage for next 450 TB 1 GB x 30 days
EU S3SU1300 30d per 1 GB S3 Object Storage above 500 TB 1 GB x 30 days

Traffic In/Out

Location MeterID Meter Description Unit
EU / US CTI1000 1 GB cumulative traffic inbound 1 GB
EU / US CTO1100 1 GB cumulative traffic outbound for first 10 TB 1 GB
EU / US CTO1200 1 GB cumulative traffic outbound for next 40 TB 1 GB
EU / US CTO1300 1 GB cumulative traffic outbound for next 100 TB 1 GB
EU / US CTO1400 1 GB cumulative traffic outbound for above 150 TB 1 GB

Traffic Usage

These values report total traffic for Virtual Data Centers and S3 Object Storage.

Location MeterID Meter Description Unit
EU / US TI1000 1 GB traffic inbound 1 GB
EU / US TO1000 1 GB traffic outbound 1 GB
EU S3TI1000 1 GB S3 total traffic inbound 1 GB
EU S3TO1000 1 GB S3 total traffic outbound 1 GB

License

Location MeterID Meter Description Unit
EU / US WL1000 1h per core AMD MS Windows license 1 hour
EU / US WL2000 1h per core Intel MS Windows license Intel (+1 hyper-thread core) 1 hour
EU / US WL3000 1h per core AMD MS Windows 2016 license 1 hour
EU / US WL4000 1h per core Intel MS Windows 2016 license Intel (+1 hyper-thread core) 1 hour
EU / US WL5000 1h per Cube core MS Windows license 1 hour
EU / US WL6000 1h per Cube core MS Windows 2016 license 1 hour

swagger 3 Source url

Authentication

Basic Authentication

Basic authentication is a very simple authentication scheme that is built into the HTTP protocol. The client sends HTTP requests with the Authorization header that contains the Basic word followed by a space and a base64-encoded username:password string. For example, a header containing the demo/p@55w0rd credentials would be encoded as:
Authorization: Basic ZGVtbzpwQDU1dzByZA==


evn

Returns provisioning itemized data for a current month

get https://api.ionos.com/billing /{contract}/evn Try out

Returns provisioning itemized data for a certain period

get https://api.ionos.com/billing /{contract}/evn/{period} Try out

maintenance

Check the API health

get https://api.ionos.com/billing /intern/ping Try out

invoices

Returns a list of all invoices.

get https://api.ionos.com/billing /{contract}/invoices Try out

Returns the invoice for a given invoice ID.

get https://api.ionos.com/billing /{contract}/invoices/{id} Try out

Returns the invoices of all billing profiles of the user for a given period.

get https://api.ionos.com/billing /invoices/{period} Try out

products

Returns a list of products available for the given contract (only billable and active)

get https://api.ionos.com/billing /{contract}/products Try out

profile

Retrieves the billing profile(s) of the authenticated account

get https://api.ionos.com/billing /profile Try out

traffic

Get a high-granularity list of utilization resources for current month by default

get https://api.ionos.com/billing /{contract}/traffic Try out

Get a high-granularity list of utilization resources for a certain period

get https://api.ionos.com/billing /{contract}/traffic/{period} Try out

usage

Returns the usage of a contract

get https://api.ionos.com/billing /{contract}/usage Try out

Returns the usage of a contract for a given data-center

get https://api.ionos.com/billing /{contract}/usage/{dc} Try out

utilization

Get a high-granularity data of resources utilization

get https://api.ionos.com/billing /{contract}/utilization Try out

Get a high-granularity data of resources utilization for a certain period

get https://api.ionos.com/billing /{contract}/utilization/{period} Try out