API Reference

Automate your infrastructure with the Metal on Cloud REST API. Deploy servers, manage networks, and integrate with your existing tools.

Request API AccessView Endpoints

Base URL

https://api.metaloncloud.com

Authentication

All API requests require authentication using Bearer tokens. Include your API key in the Authorization header:

curl -X GET "https://api.metaloncloud.com/v1/servers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Endpoints

GET/v1/serversList all servers in your account
POST/v1/serversProvision a new bare metal server
GET/v1/servers/{id}Get server details
DELETE/v1/servers/{id}Terminate a server
POST/v1/servers/{id}/rebootReboot a server
GET/v1/networksList network configurations
GET/v1/ipsList IP address allocations

Example Response

GET /v1/servers returns a list of your servers:

{
  "data": [
    {
      "id": "srv_abc123",
      "name": "web-server-01",
      "status": "running",
      "plan": "performance",
      "region": "nairobi-1",
      "ipv4": "196.x.x.x",
      "created_at": "2026-01-01T00:00:00Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 25
  }
}

Rate Limits

1,000

Requests per hour

100

Requests per minute

10

Concurrent requests

API in Development

Our API is currently in private beta.Contact usto request early access.