---
title: "Paginated game server search with filters and sorting"
method: GET
path: "/v2/game-servers"
---

# Paginated game server search with filters and sorting

`GET /v2/game-servers`

## Query parameters

- `game_title` string — Filter by game title code
- `hostname` string — Filter by hostname (case-insensitive regex match)
- `ip` string — Filter by IP address
- `online` boolean — Filter by online status
- `map` string — Filter by map name
- `country` string — Filter by ISO-2 country code (e.g. DE, US)
- `sort` 'rank' | 'rank_score' | 'players' | 'slots' | 'updated_at' | 'hostname' | 'map' | 'country' — Sort field
- `order` 'asc' | 'desc' — Sort direction
- `min_players` integer — Minimum player count
- `max_players` integer — Maximum player count
- `password` boolean — Filter by password protection
- `official` boolean — Filter by official server flag
- `modded` boolean — Filter by modded server flag
- `page` integer — Page number
- `limit` integer — Items per page

## Response `200`

Successful response

- object
  - `game_servers` unknown[]
    - unknown
  - `meta` object
    - `pagination` object
      - `current_page` string
      - `has_next` string
      - `has_prev` string
      - `per_page` string
      - `total_items` string
      - `total_pages` string

## Other responses

- `429` — Rate limit exceeded - 60 requests per 60s by scope "endpoint"

---

[API](https://skmtc.dev/cftools/apis/gameserverdataservice.md) · [All operations](https://skmtc.dev/cftools/apis/gameserverdataservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cftools/gameserverdataservice/revisions/df48f53723b0/schema)