List Servers - RunCloud

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

accept

string

required

Example:

application/json

Body Params application/json

object {0}

Example

{}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://manage.runcloud.io/api/v3/servers' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw ''

Responses

🟢200Success

application/json

Body

id

integer

required

Server ID

name

string

required

Server Name

provider

string

required

Server Provider

stack

string

required

Stack of the server whether native or containerized

ipAddress

string

required

IP Address of the server

country_iso_code

string

required

os

string

required

Operating system of the server

osVersion

string

required

Version of the OS

connected

boolean

required

Status of the server whether it's connected to RunCloud or not

online

boolean

required

Status of the server whether it's online or not

agentVersion

string

required

RunCloud agent version

phpCLIVersion

string

required

PHP CLI version

softwareUpdate

boolean

required

Auto software update

securityUpdate

boolean

required

Auto security update

transferStatus

string

required

Status on whether the server is transferrable or not

created_at

string

required

The time that the server was created at

tags

array[string]

required

Server tags

Example

{
  "data": [
    {
      "id": 1903,
      "name": "server hello",
      "provider": "Akamai (Linode)",
      "stack": "nginx",
      "ipAddress": "139.162.123.253",
      "country_iso_code": "JP",
      "os": "Ubuntu",
      "osVersion": "focal",
      "connected": true,
      "online": true,
      "agentVersion": "2.8.7-1+ubuntu20.04+11",
      "phpCLIVersion": "php81rc",
      "softwareUpdate": false,
      "securityUpdate": true,
      "transferStatus": "AVAILABLE",
      "created_at": "2024-07-09 06:56:05",
      "tags": []
    },
    {
      "id": 11101,
      "name": "server hi",
      "provider": "Akamai (Linode)",
      "stack": "nginx",
      "ipAddress": "172.104.88.73",
      "country_iso_code": "JP",
      "os": "Ubuntu",
      "osVersion": "focal",
      "connected": true,
      "online": true,
      "agentVersion": "2.8.7-1+ubuntu20.04+11",
      "phpCLIVersion": "php81rc",
      "softwareUpdate": false,
      "securityUpdate": true,
      "transferStatus": "AVAILABLE",
      "created_at": "2024-07-09 06:41:52",
      "tags": []
    },
    {
      "id": 30303,
      "name": "server bello",
      "provider": "digitalocean",
      "stack": "nginx",
      "ipAddress": "12.24.3.232",
      "country_iso_code": null,
      "os": "Ubuntu",
      "osVersion": null,
      "connected": false,
      "online": false,
      "agentVersion": null,
      "phpCLIVersion": "php81rc",
      "softwareUpdate": false,
      "securityUpdate": true,
      "transferStatus": "AVAILABLE",
      "created_at": "2024-07-16 02:10:42",
      "tags": []
    },
    {
      "id": 762,
      "name": "uiux improvement test ali",
      "provider": "Akamai (Linode)",
      "stack": "nginx",
      "ipAddress": "172.105.197.220",
      "country_iso_code": "JP",
      "os": "Ubuntu",
      "osVersion": "focal",
      "connected": true,
      "online": true,
      "agentVersion": "2.8.7-1+ubuntu20.04+11",
      "phpCLIVersion": "php81rc",
      "softwareUpdate": false,
      "securityUpdate": true,
      "transferStatus": "AVAILABLE",
      "created_at": "2024-07-11 02:35:00",
      "tags": []
    }
  ],
  "meta": {
    "pagination": {
      "total": 4,
      "count": 4,
      "per_page": 15,
      "current_page": 1,
      "total_pages": 1,
      "links": {}
    }
  }
}