How to Bytemark


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.