Usage and Reporting

Monthly usage report

Retrieve usage data across all your Clouds within a time period. The default period is the current calendar month.

GET /v3/flexVM/reports/monthly?start=2026-01-01T00:00:00Z&end=2026-02-01T00:00:00Z
Host: api.i3d.net
PRIVATE-TOKEN: YOUR_API_KEY

The usage is reported across the following aggregates:

• by_tag — usage grouped by tag:

  • active_vms: number of currently active VMs.

  • tag: the tag (e.g. env:test).

  • total_vm_hours: total number of hours VMs have run.

  • total_vms_created: total number of VMs created.

  • total_vms_released: total number of VMs released.

• clouds — the same fields as by_tag, grouped per Cloud.

• vms — the full list of VMs, with creation and deletion timestamps:

  • cloud_id: UUID of the Cloud in which the VM was created.

  • image: image name of the VM (e.g. ubuntu-2404-server-amd64).

  • name: name of the VM.

  • plan: Instance Type of the VM.

  • site: site location of the VM (tied to the Cloud).

  • status: operational status (e.g. created, deleted, failed, stopped).

  • tags: optional array of tags.

  • vm_hours: number of running hours of the VM.