---
title: "Search for friends by name using a text query."
method: GET
path: "/v1/users/{userId}/friends/search"
tags: ["Connections", "Users"]
---

# Search for friends by name using a text query.

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

## Path parameters

- `userId` integer, required

## Query parameters

- `query` string
- `cursor` string
- `limit` integer

## Response `200`

OK

- RobloxPagingCursoredPagedResultRobloxFriendsApiModelsResponseFriendResponse
  - `PreviousCursor` string
  - `PageItems` RobloxFriendsApiModelsResponseFriendResponse[]
    - `id` integer — The friend's userId
    - `hasVerifiedBadge` boolean — The friend's verified badge status.
  - `NextCursor` string
  - `HasMore` boolean

## Other responses

- `400` — 1: The target user is invalid or does not exist. 6: Invalid parameters.
- `401` — 0: Authorization has been denied for this request.

---

[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/revisions/9e4acc812347/schema)