---
title: "GET /users/{username}/friends"
method: GET
path: "/users/{username}/friends"
tags: ["users"]
---

# GET /users/{username}/friends

`GET /users/{username}/friends`

## Request

- Base URL: `https://api.jikan.moe/v4`
- URL: `https://api.jikan.moe/v4/users/{username}/friends`
- Auth: none declared

## Path parameters

- `username` string, required

## Query parameters

- `page` integer

## Response `200`

Returns user friends

- UserFriends: User Friends
  - `data` object[]
    - `user` UserMeta
      - `username` string: MyAnimeList Username
      - `url` string: MyAnimeList Profile URL
      - `images` UserImages
        - `jpg` object: Available images in JPG
          - `image_url` string, nullable: Image URL JPG
        - `webp` object: Available images in WEBP
          - `image_url` string, nullable: Image URL WEBP
    - `last_online` string: Last Online Date ISO8601 format
    - `friends_since` string: Friends Since Date ISO8601 format
  - `pagination` object
    - `last_visible_page` integer
    - `has_next_page` boolean

## Other responses

- `400`: Error: Bad request. When required parameters were not supplied.

## Changes

- **2022-05-20** `1a9ab0a8cc24`: 1 info
  - added the new optional `query` request parameter `page`

[Operation history](https://skmtc.dev/jikan/apis/jikan-api/changes/users/:username/friends/get.md)

---

[API](https://skmtc.dev/jikan/apis/jikan-api.md) - [All operations](https://skmtc.dev/jikan/apis/jikan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jikan/apis/jikan-api/revisions/ae6dd9d554d6?raw)