This guide was written to help you to access accounts using the Bytemark Cloud Server API.

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": [...],
Updated on May 22, 2019

Was this article helpful?

Related Articles

Have you tried Kubernetes?
Kubernetes (K8s) is helping enterprises to ship faster & scale their business. Sounds good? Let us build a K8s solution for your needs.
Register your interest