API

Basics

Base URL

https://api.turkishvps.com/v1

Authentication

Send your token as Authorization: Bearer YOUR_TOKEN. Create it in the panel under Developer → API Keys.

Tokens

Up to 10 tokens per account. Revoke any of them at any time.

Rate limit

120 requests a minute per account.

Billing

Servers ordered through the API are paid from your wallet balance, the same as in the panel.

Format

JSON requests and responses. Send Accept: application/json.

Your first request

List the plans on sale. Use the id of a plan when you order.

curl https://api.turkishvps.com/v1/plans \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Order a server

The root password must be 8 to 12 characters with a lowercase and an uppercase letter, a digit and one of ! # + $ * -.

curl -X POST https://api.turkishvps.com/v1/servers \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan_id": 17, "os_id": 5, "label": "web-1", "root_password": "Str0ng#Pass"}'

Endpoints

Account and catalog

Servers

Wallet and invoices

Support tickets

Errors

A failed request returns a 4xx status and a JSON body with a message; validation errors list each field.

HTTP/1.1 422 Unprocessable Content
{
  "message": "The root password field format is invalid.",
  "errors": { "root_password": ["The root password field format is invalid."] }
}