---
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 — A hex string of 24 characters representing an ObjectId.
      - `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 — A hex string of 24 characters representing an ObjectId.
        - `org` string, required
        - `orgAvatarUrl` string, required
        - `description` string
      - `type` 'user', required
    - object — Returned when `expand=followedAt` is set
      - `_id` string, required — A hex string of 24 characters representing an ObjectId.
      - `followedAt` string, date-time, required

## Changes

- **2026-09-08** `bd17546f47b8` — 1 warning, 2 info
  - for the `query` request parameter `expand`, the type of property `items/` changed from no type to `string`
  - added `subschema #1, subschema #2` to the `items/` response property `anyOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `items/` response property `anyOf` list for the response status `200`
- **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.dev/huggingface/apis/hub-api-endpoints/revisions/b88d4a4da99f?raw)