VPSBG's dev hub
HomePricingKnowledge BaseContact us
HomePricingKnowledge BaseContact us
  1. API Reference
  2. Servers
  • 👋 Hello
  • API Introduction
    • API Introduction
    • How to generate API key?
  • API Reference
    • User
      • 2FA
        • Get 2FA secret key
        • Enable 2FA
        • Disable 2FA
      • Update user
      • Get account information
    • Balance
      • Balance
      • Deposit funds
      • List balance transactions
    • Affiliate
      • Get affiliate information
      • List conversions
      • List payouts
      • Activate affiliate program
      • Update referral code
    • Invoices
      • List invoices
      • Download an invoice
      • Download invoices
    • Support
      • Tickets
        • List tickets
        • List departments
        • List related services
        • Get a ticket
        • Create new ticket
        • Reply to ticket
        • Mark ticket as resolved
        • Download attachment
      • List plans
      • Purchase support plan
      • Renew support plan
      • Cancel support plan
      • Undo cancel request
    • SSH Keys
      • Get an SSH Key
      • Update SSH Key
      • Delete SSH Key
      • List SSH keys
      • Add SSH Key
    • Servers
      • Scale
        • List plans
        • Calculate scale cost
        • Scale a server
      • Addons
        • List available addons
        • Scale addons
        • Calculate scale cost
        • Purchase new addons
        • Cancel addon
        • Undo cancel request
      • Rescue
        • Enable rescue mode
        • Disable rescue mode
      • List plans
        GET
      • List servers
        GET
      • Server status
        GET
      • Get a server
        GET
      • Server metrics
        GET
      • Bandwidth
        GET
      • Deploy new server
        POST
      • Start a server
        POST
      • Restart a server
        POST
      • Stop a server
        POST
      • Power off
        POST
      • Cancel server
        POST
      • Undo cancel request
        DELETE
      • Change password
        PUT
      • Update hostname
        PUT
      • Update SSH Keys
        PATCH
      • Modify ISOs
        POST
      • Restore
        POST
      • Renew server
        POST
      • Reinstall Server
        POST
      • Change Primary IP
        POST
      • Calculate renew amount
        POST
    • Plans
      • Plan addon
      • Plan promo-codes
    • Snapshots
      • List snapshots
      • Delete snapshot
    • Backups
      • List backups
      • Delete backup
    • Server Images
      • List server images
    • Floating IPs
      • List Floating IPs
      • Plans
      • Purchase Floating IPs
      • Attach Floating IP
      • Detach Floating IP
      • Cancel Floating IP
      • Delete Floating IP Cancellation
    • IP Addresses
      • Update IP address
    • Network Protection
      • Geo filter
        • Get current geo filter
        • Set geo filter
        • Update geo filter
        • Delete geo filter
      • Whitelist
        • Get status and list of IPs
        • Whitelist IP addresses
        • Update IP addresses list
        • Delete all rules
      • Blacklist
        • Get status and list of IPs
        • Blacklist IP addresses
        • Update IP addresses list
        • Delete all rules
      • General information
      • Bandwidth
      • List blocked IPs
      • List attacks
      • Get an attack
      • Attack bandwidth
    • Orders
      • List orders
      • Get an order
      • Delete order
      • Pay orders
      • Update order
      • Change renewal period
    • ISOs
      • Get an ISO
      • Delete an ISO
      • List ISOs
      • Add ISO
  1. API Reference
  2. Servers

Server status

GET
https://api.vpsbg.eu/v1/servers/{id}/status
Servers
This endpoint will return live information about your server.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
id
integer 
required
Header Params
Accept
string 
required
Default:
application/json

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 'https://api.vpsbg.eu/v1/servers//status' \
--header 'Accept;'

Responses

🟢200Live information regarding your server - current resource usage, state and additional information.
application/json
Body
running
boolean 
required
suspended
boolean 
required
network_suspended
boolean 
required
rescue_mode
boolean 
required
dns_resolvers
array[string]
required
cpu
object 
required
used
number 
required
free
number 
required
disk
object 
required
Returns disk space in GB.
used
integer 
required
limit
integer 
required
ram
object 
required
used
number  | null 
optional
limit
integer  | null 
optional
bandwidth
object 
required
Returns bandwidth in GB.
used
number 
required
limit
integer 
required
Returns RAM in GB.
isos
object 
required
primary
optional
secondary
optional
boot_from_iso
boolean 
required
Example
{
  "running": true,
  "suspended": false,
  "network_suspended": false,
  "rescue_mode": false,
  "dns_resolvers": [
    "9.9.9.9",
    "208.67.222.222"
  ],
  "cpu": {
    "used": 1.7,
    "free": 98.3
  },
  "disk": {
    "used": 0,
    "limit": 50
  },
  "ram": {
    "used": 1288,
    "limit": 2000
  },
  "bandwidth": {
    "used": 0.03,
    "limit": 5000
  },
  "isos": {
    "primary": {
      "id": 1,
      "status": "downloaded",
      "name": "AlmaLinux-9.5-x86_64-boot.iso",
      "size": 1111998464,
      "downloaded": 1111998464,
      "created_at": "2025-02-03T10:58:19.000000Z",
      "deletion_at": "2025-02-05T10:58:19.000000Z"
    },
    "secondary": null,
    "boot_from_iso": false
  }
}
🔴500Server Error
Modified at 2025-03-25 12:58:34
Previous
List servers
Next
Get a server
Built with