List servers

Retrieve a list of all servers in your account.

GET/api/servers

List all servers

This endpoint allows you to retrieve a paginated list of all your servers.

Full PHP versions

php_full_versions holds the full version of every installed PHP version, for example "8.3": "8.3.27". Ploi reads these from PHP-FPM every night, after a PHP version is patched and after updates installed packages on the server. php_full_versions_checked_at is when the oldest of them was read (UTC). A version is null when it has not been read yet.

Required scopes

Read servers

Request

GET

/api/servers

curl -G "https://ploi.io/api/servers" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

Response

{
  "data": [
    {
      "id": 1,
      "type": "server",
      "name": "awesome-server",
      "ip_address": "127.0.0.1",
      "php_version": "8.3",
      "php_cli_version": "8.3",
      "installed_php_versions": ["8.3", "8.4"],
      "php_full_versions": {
        "8.3": "8.3.27",
        "8.4": "8.4.14"
      },
      "php_full_versions_checked_at": "2026-10-27T02:00:12.000000Z",
      "mysql_version": 5.7,
      "sites_count": 0,
      "status": "Server active",
      "status_id": 0,
      "created_at": "2019-07-08 10:14:50"
    }
  ],
  "links": {
    "first": "http://ploi.io/api/servers?page=1",
    "last": "http://ploi.io/api/servers?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "http://ploi.io/api/servers",
    "per_page": 15,
    "to": 3,
    "total": 3
  }
}