Docs / Using the API

Servers

List the servers belonging to a team.

  1. Endpoint
  2. Query parameters
  3. Example request
  4. Example response

Returns the servers belonging to a team.

Endpoint

GET /api/{team}/servers

Required ability: servers:read

Query parameters

Parameter Type Default Maximum Description
per_page integer 20 50 Number of objects per page.
page integer 1 N/A The page to retrieve.

Example request

curl "https://rocketeersapp.com/api/your-team/servers?per_page=20" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Example response

{
  "data": [
    {
      "id": 1,
      "name": "web-1",
      "slug": "web-1",
      "ip": "203.0.113.10",
      "provider_slug": "digitalocean",
      "server_type": "app",
      "status": "active",
      "region": "ams3",
      "price": 24.00,
      "created_at": "2026-01-15T09:30:00+00:00"
    },
    {
      "id": 2,
      "name": "db-1",
      "slug": "db-1",
      "ip": "203.0.113.20",
      "provider_slug": "hetzner",
      "server_type": "database",
      "status": "active",
      "region": "nbg1",
      "price": 18.50,
      "created_at": "2026-01-15T09:32:00+00:00"
    }
  ],
  "links": {
    "first": "https://rocketeersapp.com/api/your-team/servers?page=1",
    "last": "https://rocketeersapp.com/api/your-team/servers?page=2",
    "prev": null,
    "next": "https://rocketeersapp.com/api/your-team/servers?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 2,
    "per_page": 20,
    "to": 20,
    "total": 27,
    "path": "https://rocketeersapp.com/api/your-team/servers"
  },
  "results": 20,
  "served_in": "13.42ms"
}