How to Bytemark

Show documention menu


Your Bytemark account contains multiple groups and each of those contains several virtual machines (also called Cloud Servers). To access an account, you need to authenticate with a username.


These URLs are relative to

GET /accounts
GET /accounts?view=overview
GET /accounts?view=overview&include_deleted=true
GET /accounts/{account-id}

Setting a view parameter to overview will turn on nested information. This embeds other related information (such as the servers and groups in the account and their discs/NICs) into the response to save making HTTP calls. Note though that not all fields are necessarily included in overview mode. When view is set to overview and include_deleted is true, nested information for deleted servers will be included too.


  • id – Unique key (integer).
  • name – Account name (string).
  • suspended – Flag to indicate the account has been suspended (boolean – true/false).


Account overview

Accept: application/json
Authorization: Bearer {session-id}
curl -H "Content-type: application/json" \
     -H "Authorization: Bearer {session-id}" \
Response (success: 200)
  "id": 1,
  "name": "myaccountname",
  "suspended": false,
  "groups": [
      "id": 123,
      "name": "default",
      "virtual_machines": [...],
Bytemark Cloud used to be called "BigV"—nothing has changed except the name! We’re hiring! Please visit to find out more.