---
title: "List user followers"
method: GET
path: "/api/users/{username}/followers"
tags: ["users"]
---

# List user followers

`GET /api/users/{username}/followers`

## Path parameters

- `username` string, required

## Query parameters

- `cursor` string — Cursor for pagination
- `limit` integer — Max number of followers to return
- `expand` string[]

## Response `200`

The users following the given user

- union[]
  - union
    - object
      - `_id` string, required
      - `orgs` object[]
        - `id` string, required
        - `name` string, required
        - `fullname` string, required
        - `avatarUrl` string, required
      - `avatarUrl` string, required
      - `fullname` string, required
      - `isPro` boolean, required
      - `user` string, required
      - `numModels` number
      - `numDatasets` number
      - `numSpaces` number
      - `numBuckets` number
      - `numKernels` number
      - `numDiscussions` number
      - `numPapers` number
      - `numUpvotes` number
      - `numLikes` number
      - `numFollowers` number
      - `numFollowing` number
      - `numFollowingOrgs` number
      - `details` string
      - `isFollowing` boolean
      - `reasonToFollow` string
      - `primaryOrgAvatarUrl` string
      - `serviceAccount` object — Set when the user is a service account
        - `id` string, required
        - `org` string, required
        - `orgAvatarUrl` string, required
        - `description` string
      - `type` 'user', required
    - object — Returned when `expand=followedAt` is set
      - `_id` string, required
      - `followedAt` string, date-time, required

## Changes

- **2026-08-27** `c6333aaa0969` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/huggingface/apis/hub-api-endpoints/changes/api/users/:username/followers/get.md)

---

[API](https://skmtc.dev/huggingface/apis/hub-api-endpoints.md) · [All operations](https://skmtc.dev/huggingface/apis/hub-api-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/huggingface/hub-api-endpoints/revisions/e1c551f50478/schema)