---
title: "List available realms"
method: GET
path: "/realms"
tags: ["Realms"]
---

# List available realms

`GET /realms`

Returns all healthy catalyst realms plus the main realm if available.
Each realm includes its server name, URL, and current user count.

## Response `200`

Successful response with list of realms

- object[]
  - `serverName` string, required — Name of the realm server
  - `url` string, uri, required — Base URL of the realm
  - `usersCount` number, required — Current number of users connected to this realm

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)