Authentication

All API requests require a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_TOKEN

Getting Your API Token

Log in to the CloudBlast Panel
Go to Account Settings > API
Copy your API token

IP Whitelisting

If you’ve configured an IP whitelist in your account settings (apiAddress field), only requests from that IP address will be accepted. Requests from other IPs will receive a 403 error:

{
  "error": {
    "code": "IP_NOT_ALLOWED",
    "message": "Your IP address is not whitelisted for API access."
  }
}

To allow requests from any IP, leave the IP whitelist field empty.

Example Request

curl -H "Authorization: Bearer cb_live_abc123..." \
  https://console.cloudblast.io/api/v2/account

import requests

headers = {"Authorization": "Bearer cb_live_abc123..."}
response = requests.get(
    "https://console.cloudblast.io/api/v2/account",
    headers=headers
)
print(response.json())

const response = await fetch("https://console.cloudblast.io/api/v2/account", {
  headers: {
    Authorization: "Bearer cb_live_abc123...",
  },
});
const data = await response.json();
console.log(data);

$ch = curl_init("https://console.cloudblast.io/api/v2/account");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer cb_live_abc123..."
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = json_decode(curl_exec($ch));

req, _ := http.NewRequest("GET", "https://console.cloudblast.io/api/v2/account", nil)
req.Header.Set("Authorization", "Bearer cb_live_abc123...")
resp, _ := http.DefaultClient.Do(req)

Error Responses

Status	Code	Description
`401`	`UNAUTHENTICATED`	Missing or invalid `Authorization` header
`401`	`INVALID_TOKEN`	The API token doesn’t match any account
`403`	`ACCOUNT_BANNED`	Your account has been suspended
`403`	`IP_NOT_ALLOWED`	Request IP is not in your whitelist