---
title: "List instances following the server"
method: GET
path: "/api/v1/server/followers"
tags: ["Instance Follows"]
---

# List instances following the server

`GET /api/v1/server/followers`

## Query parameters

- `state` 'pending' | 'accepted'
- `actorType` 'Person' | 'Application' | 'Group' | 'Service' | 'Organization'
- `start` integer
- `count` integer
- `sort` string

## Response `200`

successful operation

- object
  - `data` Follow[]
    - `createdAt` string, date-time
    - `follower` Actor
      - `createdAt` string, date-time
      - `followersCount` integer — number of followers of this actor, as seen by this instance
      - `followingCount` integer — number of actors subscribed to by this actor, as seen by this instance
      - `host` string, hostname — server on which the actor is resident
      - `hostRedundancyAllowed` boolean — whether this actor's host allows redundancy of its videos
      - `id` integer
      - `name` string — immutable name of the user, used to find or mention its actor
      - `updatedAt` string, date-time
      - `url` string, url
    - `following` Actor
      - `createdAt` string, date-time
      - `followersCount` integer — number of followers of this actor, as seen by this instance
      - `followingCount` integer — number of actors subscribed to by this actor, as seen by this instance
      - `host` string, hostname — server on which the actor is resident
      - `hostRedundancyAllowed` boolean — whether this actor's host allows redundancy of its videos
      - `id` integer
      - `name` string — immutable name of the user, used to find or mention its actor
      - `updatedAt` string, date-time
      - `url` string, url
    - `id` integer
    - `score` number — score reflecting the reachability of the actor, with steps of `10` and a base score of `1000`.
    - `state` 'pending' | 'accepted'
    - `updatedAt` string, date-time
  - `total` integer

---

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