---
title: "Get list of federated servers"
method: GET
path: "/federation/servers"
tags: ["Internal", "Federation"]
---

# Get list of federated servers

`GET /federation/servers`

## Response `200`

List of federated servers

- object
  - `servers` FederatedServer[]
    - `id` integer — Unique identifier for the federated server
    - `iri` string, uri — IRI/URL of the federated server
    - `name` string — Display name of the federated server
    - `logoUrl` string, uri — URL of the server's logo image
    - `isOnline` boolean — Whether the server is currently online/streaming
    - `streamTitle` string — Title of the current stream (when online)
    - `streamDescription` string — Description of the current stream (when online)
    - `tags` string[] — Tags associated with the current stream
    - `thumbnailUrl` string, uri — URL of the current stream thumbnail
    - `lastSeenOnline` string, date-time — Last time the server was seen online
    - `lastStatusUpdate` string, date-time — Last time we received a status update
    - `addedAt` string, date-time — When we started tracking this server
    - `followedAt` string, date-time — When we started following this server

## Other responses

- `400` — Bad request
- `default` — Unexpected error

---

[API](https://skmtc.net/owncast/apis/owncast-apis.md) · [All operations](https://skmtc.net/owncast/apis/owncast-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/owncast/owncast-apis/versions/d3510588e78e/schema)