Skip to main content
GET
/
api
/
v3
/
lobbies
/
{config}
Browse lobbies
curl --request GET \
  --url https://api.computeflow.cloud/api/v3/lobbies/{config} \
  --header 'api-key: <api-key>'
{
  "lobbies": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "code": "<string>",
      "config": "<string>",
      "status": "waiting",
      "host": "<string>",
      "maxPlayers": 123,
      "currentPlayers": 123,
      "region": "<string>",
      "isPrivate": true,
      "allowLateJoin": true,
      "settings": {},
      "players": [
        {
          "id": "<string>",
          "state": {},
          "isHost": true
        }
      ],
      "server": {
        "instanceId": "<string>",
        "status": "<string>",
        "region": "<string>",
        "ports": [
          {
            "name": "<string>",
            "host": "<string>",
            "port": 123,
            "protocol": "udp"
          }
        ]
      },
      "matchmaking": {
        "mode": "<string>",
        "startedAt": "<string>",
        "queueStats": {
          "playersSearching": 123,
          "lobbiesInQueue": 123,
          "avgWaitSeconds": 123
        }
      },
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123,
  "hasMore": true
}

Authorizations

api-key
string
header
required

Path Parameters

config
string
required

Lobby configuration name or ID.

Query Parameters

region
string

Filter by region.

status
string

Filter by status (waiting, in_queue, in_game).

limit
integer
default:50

Max results per page (1–100). Defaults to 50.

Required range: 1 <= x <= 100
offset
integer | null
default:0

Pagination offset. Defaults to 0.

Required range: x >= 0

Response

200 - application/json

Paginated list of public lobbies matching the filters.

Paginated list of public lobbies.

lobbies
object[]
required

Lobbies matching the query.

total
number
required

Total matching lobbies.

limit
number
required

Page size.

offset
number
required

Page offset.

hasMore
boolean
required

True if more results exist beyond this page.