---
title: "List configured homeservers"
method: GET
path: "/ocs/v2.php/apps/spreed/api/{apiVersion}/matrix/admin/homeserver"
tags: ["matrix_admin"]
---

# List configured homeservers

`GET /ocs/v2.php/apps/spreed/api/{apiVersion}/matrix/admin/homeserver`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - HTTP basic

This endpoint requires admin access

## Path parameters

- `apiVersion` 'v1', required

## Headers

- `OCS-APIRequest` boolean, required

## Response `200`

Homeservers returned

- object
  - `ocs` object, required
    - `meta` OCSMeta, required
      - `status` string, required
      - `statuscode` integer, required
      - `message` string
      - `totalitems` string
      - `itemsperpage` string
    - `data` MatrixHomeserver[], required
      - `id` string, required: SnowflakeID
      - `name` string, required
      - `serverName` string, required
      - `baseUrl` string, required
      - `enabled` boolean, required
      - `specVersions` string[], required

## Other responses

- `401`: Current user is not logged in
- `403`: Logged in account must be an admin

## Changes

- **2026-10-08** `b0252635fe5a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nextcloud/apis/spreed-administration/changes/ocs/v2.php/apps/spreed/api/:apiVersion/matrix/admin/homeserver/get.md)

---

[API](https://skmtc.dev/nextcloud/apis/spreed-administration.md) - [All operations](https://skmtc.dev/nextcloud/apis/spreed-administration/llms.txt) - [OpenAPI document](https://skmtc.dev/nextcloud/apis/spreed-administration/revisions/255263f20554?raw)