---
title: "Get list of all friends for the specified user."
method: GET
path: "/v1/users/{userId}/friends"
tags: ["Connections", "Users"]
---

# Get list of all friends for the specified user.

`GET /v1/users/{userId}/friends`

## Path parameters

- `userId` integer, required

## Query parameters

- `userSort` 0 | 1 | 2

## Response `200`

OK

- RobloxWebWebAPIModelsApiArrayResponseRobloxFriendsApiModelsResponseUserResponse
  - `data` RobloxFriendsApiModelsResponseUserResponse[]
    - `isOnline` boolean — Whether the user is online.
    - `presenceType` 0 | 1 | 2 | 3 | 4 — Where the user is online.
    - `isDeleted` boolean — Whether the user is deleted.
    - `friendFrequentScore` integer — Frequents value for the user.
    - `friendFrequentRank` integer — Frequents rank for the user.
    - `hasVerifiedBadge` boolean — The user's verified badge status.
    - `description` string — The user description.
    - `created` string, date-time — When the user signed up.
    - `isBanned` boolean — Whether or not the user is banned
    - `externalAppDisplayName` string — Used when user is logged in from third party app (e.g. QQ) ExternalAppDisplayName is the name used in that app (e.g. QQ nickname)
    - `id` integer — The user Id.
    - `name` string — The user name.
    - `displayName` string — The user DisplayName.

## Other responses

- `400` — 1: The target user is invalid or does not exist.

---

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