Regions API

Region codes, and which services each region offers.

Wherever the API takes a region, send the lowercase code from GET /v1/regions — for example no (Norway), se (Sweden), dk (Denmark), fi (Finland). The same code appears in hostnames such as {cluster_id}.k8s.no.wayscloud.services.

Two products had their own spelling before these codes. They still accept it, and their responses still use it:

Product	Also accepted (any letter case)	Responses use
Object Storage	no-oslo-1	no (the only region currently offered)
VPS	oslo, norway, no-oslo-1, stockholm, sweden, frankfurt, germany, paris, france	NO

VPS is also offered outside these regions: for VPS, region is the ISO 3166-1 country code of the location (de, nl, …).

The S3 signing region in the S3 examples is no, an S3 client setting; /v1/ip returns a geographic region (state or province), which is not a region code.

GET /v1/regions needs no authentication.

Endpoints

Method	Path	Description
GET	/v1/regions	List regions
GET	/v1/regions/{region_code}	Get region

GET /v1/regions

List regions

List region codes and the services that can be ordered in each. No authentication.

Response:

Field	Type	Description
regions	array
total	integer

Example:

curl https://api.wayscloud.services/v1/regions \
  -H "X-API-Key: wayscloud_pat_abc12_YOUR_SECRET"

Response:

{
  "regions": [
    {
      "code": "no",
      "name": "Norge",
      "city": "Oslo",
      "country": "NO",
      "status": "active",
      "available_services": [
        "storage",
        "databases",
        "redis",
        "apps",
        "llm"
      ]
    },
    {
      "code": "se",
      "name": "Sverige",
      "city": "Stockholm",
      "country": "SE",
      "status": "active",
      "available_services": [
        "databases"
      ]
    }
  ],
  "total": 2
}

---

GET /v1/regions/

Get region

Get one region and the services that can be ordered in it. No authentication.

Response:

Field	Type	Description
code	string	Region code — send this wherever the API takes region
name	string	Display name (currently Norwegian). Do not parse; use code.
city	string	Display name of the city
country	string	ISO 3166-1 alpha-2 country code
status	string	Values: active, maintenance, deprecated
available_services	array	Services that can be ordered in this region now. Empty unless status is active. VPS locations are chosen by country code instead, and DNS is not regional.

Example:

curl https://api.wayscloud.services/v1/regions/{region_code} \
  -H "X-API-Key: wayscloud_pat_abc12_YOUR_SECRET"

Response:

{
  "code": "no",
  "name": "Norge",
  "city": "Oslo",
  "country": "NO",
  "status": "active",
  "available_services": [
    "storage",
    "databases",
    "redis",
    "apps",
    "llm"
  ]
}

---