VirtFusion Global API
  1. External Relational ID
VirtFusion Global API
  • General
    • Test connection
      GET
  • Hypervisors
    • Retrieve hypervisors
      GET
    • Retrive a Hypervisor
      GET
  • Hypervisor Groups
    • Retrieve hypervisor groups
      GET
    • Retrieve a hypervisor group
      GET
    • Retrieve a hypervisor groups resources
      GET
  • Servers
    • Network
      • Firewall
        • Disable firewall
        • Enable firewall
        • Retrieve firewall
        • Apply firewall rulesets
      • Add an address to the whitelist
      • Remove an address from the whitelist
      • Add a quantity of IPv4 addresses
      • Add an array of IPv4 addresses
      • Remove an array of IPv4 addresses
    • Power
      • Boot a server
      • Shutdown a server
      • Restart a server
      • Poweroff a server
    • Traffic
      • Add a traffic block to a server
      • Remove a traffic block from a server
      • Retrieve a servers traffic blocks
    • Retrieve a server
    • Add, remove or modify a backup plan
    • Build a server
    • Change a server package
    • Create a server
    • Delete a server
    • Retrieve servers
    • Modify a server name
    • Reset a server password
    • Retrieve a users servers
    • Retrieve OS templates available to a server
    • Suspend a server
    • Throttle a servers CPU
    • Retrieve a servers traffic statistics
    • Unsuspend a server
    • Enable or disable VNC for a server
    • Change Owner
    • Modify primary traffic allowance
  • IP Blocks
    • Add an IPv4 range to an IP block
    • Retrieve IP blocks
    • Retrieve an IP block
  • Backups
    • Retrieve a server backups
  • DNS
    • Retrieve a DNS service
  • Media
    • Retrieve an ISO
    • Retrieve operating system templates that are available for a package
  • Packages
    • Retrieve packages
    • Retrieve a packge
  • Queue & Tasks
    • Retrieve a queue item
  • SSH Keys
    • Add an SSH key to a user account
    • Delete an SSH key from a user
    • Retrieve a users SSH keys
    • Retrieve an SSH key
  • Users
    • External Relational ID
      • Delete a user
      • Generate a set of login tokens
      • Generate a set of loging tokens using a server ID
      • Modify a user
      • Change a user passowrd
      • Retrieve a user
    • Create a user
  • Self Service
    • External Relational ID
      • Add credit to user
        POST
      • Add an hourly group profile to a user
        POST
      • Add a resource group profile to a user
        POST
      • Add a resource pack to a user
        POST
      • Retrieve hourly statistics
        GET
      • Modify user access
        PUT
      • Remove hourly group profile from a user
        DELETE
      • Remove resource group from a user
        DELETE
      • Generate a report
        GET
      • Set an hourly resource pack
        PUT
      • Retrieve a users usage
        GET
    • Cancel credit that was applied to a user
      DELETE
    • Delete all servers attached to a pack ID
      DELETE
    • Delete a user resource pack
      DELETE
    • Retrieve a user resource pack
      GET
    • Modify user resource pack
      PUT
    • Retrieve currencies
      GET
    • Suspend all servers assigned to a reosurce pack
      POST
    • Unsuspend all servers assigned to a reosurce pack
      POST
  1. External Relational ID

Generate a report

Developing
GET
/selfService/report/byUserExtRelationId/{extRelationId}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Query Params

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/selfService/report/byUserExtRelationId/1?period=0&currency=USD'

Responses

🟢200Success
application/json
Body

Example
{
    "data": {
        "usage": {
            "servers": [],
            "serversTotal": {
                "hours": false,
                "value": false,
                "tokens": false
            },
            "hourConversionRate": false,
            "monthlyTotal": {
                "hours": false,
                "value": false,
                "tokens": false
            },
            "addonsTotal": {
                "hours": 0,
                "value": 0,
                "tokens": false
            },
            "taxStatus": 3,
            "success": false,
            "history": "0",
            "breakdown": true,
            "term": "January 2025",
            "previousTerm": "December 2024",
            "nextTerm": "February 2025",
            "period": {
                "ymd": "2025-01-01",
                "start": "2025-01-01T00:00:00+00:00",
                "end": "2025-01-31T00:00:00+00:00"
            },
            "showHourlyRate": false,
            "showMonthlyRate": false
        },
        "currency": {
            "prefix": "",
            "suffix": "",
            "code": "",
            "currentValue": 0,
            "value": 0,
            "default": {
                "prefix": "",
                "suffix": "",
                "code": ""
            }
        },
        "limits": {
            "success": true,
            "packs": []
        }
    }
}
🟠401401
Modified at 2025-01-20 21:49:10
Previous
Remove resource group from a user
Next
Set an hourly resource pack
Built with