Order a VPS with the EDIS Global API (Complete Guide)

Simple Guide
Developer Version
Full Example

Let’s Keep This Simple

If you want to order a VPS using the EDIS Global API, think of it like this:👉 You don’t start by ordering
👉 You first collect all the pieces you needOnly after that, you send one final request.

The Basic Idea

Imagine ordering a VPS like ordering food:You need to decide:

where (location)
what (plan)
how often you pay (billing cycle)
how you pay (payment method)
extras (RAM, IPs, etc.)

The API works exactly the same way.

Step-by-Step Overview

Use your EDIS Global email + password (same as Client Portal)

Get available options

Ask the API:

what billing cycles exist
what payment methods exist
what locations exist

Pick a location

Choose where your VPS should be deployed

Get plans for that location

This gives you:

product IDs (pid)
OS IDs
addon IDs

Build your order

Put everything together into one JSON request

Send the order

Call the order endpoint

Step 1: Get Billing Cycles

Just ask the API what billing cycles exist.

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/get/billingcycles \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD

You’ll get something like:

["monthly", "quarterly", "annually"]

👉 Pick one.

Step 2: Get Payment Methods

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/get/paymentmethods \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD

Example result:

["paypal", "creditcard"]

👉 Pick one.

Step 3: Get VPS Locations

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/get/locations \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD

You’ll see something like:

"Greece": { "id": 94, "out_of_stock": false }

👉 Important:

use the id
ignore locations where out_of_stock = true

Step 4: Get VPS Plans (This Is the Important One)

Now you ask:👉 “What can I buy in this location?”

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/get/products \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD \
  --data location_id=94

Now you get everything:

plan IDs → pid
OS IDs → os
addon IDs → RAM, IPs, etc.

Step 5: Pick What You Want

From that response, choose:

plan → pid
OS → os
optional:
- RAM
- CPU
- IPs
- disk 👉 Everything is just IDs.

Final Step: Send the Order

Now you finally send the order:

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/add/order \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD \
  --data 'order={
    "billingcycle": "monthly",
    "paymentmethod": "paypal",
    "item": [
      {
        "pid": 892,
        "os": 208,
        "hostname": "my-server",
        "additional_ram": 396,
        "additional_ip": 10
      }
    ]
  }'

What Happens Next?

If everything is correct, you get:

{
  "status": "success",
  "orderid": 123,
  "serviceids": "456",
  "invoiceid": 789
}

That means:✅ Order created
✅ Invoice created
✅ VPS is being deployed

Key Takeaway

👉 The API is simple once you understand this:

Ask for options
Pick IDs
Send order

That’s it.

Pro Tip

Always fetch locations and products dynamically.IDs can change, new locations can appear, stock can change, and new plans can appear.Account credit will be applied automatically, regardless of the payment method you choose.

If You Get Stuck

Think of it like this:👉 “What values do I still NOT have?”Then go back and call the endpoint that gives you that value.That’s the whole workflow.

Order a VPS the Right Way

When ordering a VPS through the EDIS Global Order API, the most important step is not sending the final request first.👉 First collect all required values
👉 Then send one clean order requestThis approach avoids errors and ensures successful provisioning.

This guide uses curl examples for clarity. The same workflow works with Python, PHP, JavaScript, Postman, or any HTTP client.

API Workflow

Authenticate

Use your EDIS Global Client Portal email and password

Collect values

Retrieve billing cycles, payment methods, locations, products, and addon IDs

Build payload

Combine all selected values into one JSON structure

Submit order

Send the final request to the order endpoint

Important: Payment Method Behavior

The selected paymentmethod defines how the first invoice and all renewal invoices are issued.If account credit is available, it is automatically applied, and orders are typically delivered in near real-time.

Try the API Directly in the Documentation

All endpoints can be tested directly in the documentation portal.You can execute live requests and switch between multiple programming languages such as cURL, Python, JavaScript, PHP, Go, Java, and Ruby.

This is the fastest way to validate your integration before writing code.

Available Endpoints

Final Order Endpoint

POST https://order.edisglobal.com/kvm/v2/add/order

Example payload:

{
  "billingcycle": "monthly",
  "paymentmethod": "paypal",
  "applycredit": false,
  "item": [
    {
      "pid": 892,
      "os": 208,
      "hostname": "my-server",
      "additional_ram": 396,
      "additional_ip": 10
    }
  ]
}

Example: Successful Response

{
  "status": "success",
  "orderid": 123456,
  "serviceids": "123456",
  "invoiceid": 654321,
  "invoicepaid": true
}

Best Practices

Always fetch locations, products, and addon IDs dynamically.Inventory, availability, and IDs can change at any time.

Before submitting an order, verify:

location is not out of stock
product exists in that location
OS is valid for that product
addon IDs belong to the same product response

Summary

To order a VPS:

get billing cycles
get payment methods
get locations
get products
collect IDs
submit order

👉 Collect first. Order last.

Full Example (End-to-End)

This example walks through the complete workflow:👉 collect all required values
👉 build the payload
👉 submit the order

Step 1: Get Billing Cycle

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/get/billingcycles \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD

Example result:

{
  "billingcycle": ["monthly", "quarterly", "annually"]
}

👉 We choose: monthly

Step 2: Get Payment Method

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/get/paymentmethods \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD

Example result:

{
  "paymentmethods": ["paypal", "creditcard"]
}

👉 We choose: paypal

Step 3: Get VPS Locations

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/get/locations \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD

Example result:

{
  "KVM Greece": {
    "id": 94,
    "out_of_stock": false
  }
}

👉 We choose: location_id = 94

Step 4: Get VPS Products in Location

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/get/products \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD \
  --data location_id=94

Example result (simplified):

{
  "KVM STARTER": {
    "id": 892,
    "addons": {
      "operating system": {
        "208": "Debian 12"
      },
      "additional ram": {
        "396": "+1GB"
      },
      "additional ip": {
        "10": "2 IPs"
      }
    }
  }
}

👉 We select:

pid = 892
os = 208
additional_ram = 396
additional_ip = 10

Step 5: Build Order Payload

{
  "billingcycle": "monthly",
  "paymentmethod": "paypal",
  "applycredit": false,
  "item": [
    {
      "pid": 892,
      "os": 208,
      "hostname": "example-greece-server",
      "additional_ram": 396,
      "additional_vcpu": "",
      "additional_ip": 10,
      "additional_diskboost": "",
      "ssh_pubkey": ""
    }
  ]
}

Step 6: Submit Order

curl --request POST \
  --url https://order.edisglobal.com/kvm/v2/add/order \
  --data email=YOUR_EMAIL \
  --data pw=YOUR_PASSWORD \
  --data 'order={...}'

Successful Response

{
  "status": "success",
  "orderid": 264401,
  "serviceids": "356728",
  "invoiceid": 1764460,
  "invoicepaid": true
}

What Just Happened

Order was created
Invoice was generated
Credit (if available) was applied automatically
VPS provisioning started

Key Insight

👉 Every value used in the final request comes from previous API callsThere are no hardcoded values.

Pro Tip

Use the documentation portal to test each step before implementing your integration.https://docs.edisglobal.com/order-api-reference/order-vps

Final Summary

get billing cycles
get payment methods
get locations
get products
collect IDs
submit order

👉 This is the complete workflow.

​Let’s Keep This Simple

​The Basic Idea

​Step-by-Step Overview

​Step 1: Get Billing Cycles

​Step 2: Get Payment Methods

​Step 3: Get VPS Locations

​Step 4: Get VPS Plans (This Is the Important One)

​Step 5: Pick What You Want

​Final Step: Send the Order

​What Happens Next?

​Key Takeaway

​Pro Tip

​If You Get Stuck

​Order a VPS the Right Way

​API Workflow

​Important: Payment Method Behavior

​Try the API Directly in the Documentation

​Available Endpoints

​Final Order Endpoint

​Example: Successful Response

​Best Practices

​Summary

​Full Example (End-to-End)

​Step 1: Get Billing Cycle

​Step 2: Get Payment Method

​Step 3: Get VPS Locations

​Step 4: Get VPS Products in Location

​Step 5: Build Order Payload

​Step 6: Submit Order

​Successful Response

​What Just Happened

​Key Insight

​Pro Tip

​Final Summary

Let’s Keep This Simple

The Basic Idea

Step-by-Step Overview

Step 1: Get Billing Cycles

Step 2: Get Payment Methods

Step 3: Get VPS Locations

Step 4: Get VPS Plans (This Is the Important One)

Step 5: Pick What You Want

Final Step: Send the Order

What Happens Next?

Key Takeaway

Pro Tip

If You Get Stuck

Order a VPS the Right Way

API Workflow

Important: Payment Method Behavior

Try the API Directly in the Documentation

Available Endpoints

Final Order Endpoint

Example: Successful Response

Best Practices

Summary

Full Example (End-to-End)

Step 1: Get Billing Cycle

Step 2: Get Payment Method

Step 3: Get VPS Locations

Step 4: Get VPS Products in Location

Step 5: Build Order Payload

Step 6: Submit Order

Successful Response

What Just Happened

Key Insight

Pro Tip

Final Summary