API Documentation

Introduction

The Baraclouds API is a RESTful API that allows you to programmatically manage your cloud resources. All requests should be made over HTTPS.

Authentication

All API requests require authentication using an API key. Include your API key in the X-API-Key header.

curl -X GET https://api.baraclouds.com/v1/status \
  -H "X-API-Key: YOUR_API_KEY"

Base URL

https://api.baraclouds.com/v1

List Virtual Machines

Response

[
  {
    "id": "vm-123456",
    "name": "my-server",
    "instance_type": "t2.micro",
    "region": "us-east-1",
    "status": "running",
    "ip_address": "10.0.1.42",
    "created_at": "2026-03-10T10:30:00Z"
  }
]

Create Virtual Machine

Request Body

{
  "name": "my-server",
  "instance_type": "t2.micro",
  "region": "us-east-1",
  "tags": "web,production"
}

Response

{
  "message": "VM created successfully",
  "vm_id": "vm-123456",
  "ip_address": "10.0.1.42"
}

Start Virtual Machine

Response

{
  "message": "VM starting",
  "vm_id": "vm-123456",
  "status": "starting"
}

Stop Virtual Machine

Response

{
  "message": "VM stopped",
  "vm_id": "vm-123456"
}

Delete Virtual Machine

Response

{
  "message": "VM deleted successfully"
}

Add Credits

Request Body

{
  "amount": 50,
  "payment_method": "credit_card"
}

Response

{
  "message": "Credits added successfully",
  "new_balance": 150.00
}

Billing History

Response

[
  {
    "id": 1,
    "amount": 50.00,
    "description": "Credit purchase",
    "status": "completed",
    "timestamp": "2026-03-10T10:30:00Z"
  }
]