Get Started

Cloud API Documentation

Welcome to the FreeVPSTrial.net Cloud API. You can use our REST API to programmatically manage instances, fetch billing data, and automate your infrastructure scaling.

Base URL: https://api.freevpstrial.net/v2

Authentication

The API uses Bearer Token authentication. You can generate an API Key from your dashboard under "Settings > API Keys".

Authorization: Bearer YOUR_API_KEY

Instances

GET /instances

Returns a list of all VPS instances associated with your account.

curl -X GET https://api.freevpstrial.net/v2/instances \
  -H "Authorization: Bearer $API_TOKEN"

Response Example:

{
  "instances": [
    {
      "id": "10492",
      "name": "dev-server-01",
      "status": "running",
      "ip_address": "192.168.1.50",
      "region": "nyc1",
      "created_at": "2026-01-15T10:00:00Z"
    }
  ]
}

POST /instances

Provision a new VPS instance.

Parameter Type Required Description
name string Yes A unique name for the server.
region string Yes Slugs: nyc1, fra1, sgp1
image string Yes OS slug (e.g., ubuntu-24-04)
size string Yes Plan slug (e.g., s-1vcpu-2gb) 
curl -X POST https://api.freevpstrial.net/v2/instances \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_TOKEN" \
  -d '{"name":"web-01", "region":"nyc1", "size":"s-1vcpu-2gb", "image":"ubuntu-24-04"}'

DELETE /instances/{id}

Permanently destroy a VPS instance and all associated data.

curl -X DELETE https://api.freevpstrial.net/v2/instances/10492 \
  -H "Authorization: Bearer $API_TOKEN"

Errors

The API uses standard HTTP status codes to indicate the success or failure of requests.