---
title: "Get a page of friends that the authenticated user can add as trusted friends. Friends with a pending trusted friend request from the user come after the other friends. A page can be short or empty and still have a cursor, so request pages until nextPageCursor is null."
method: GET
path: "/v1/my/trusted-friends/candidates"
tags: ["Connections"]
---

# Get a page of friends that the authenticated user can add as trusted friends. Friends with a pending trusted friend request from the user come after the other friends. A page can be short or empty and still have a cursor, so request pages until nextPageCursor is null.

`GET /v1/my/trusted-friends/candidates`

## Request

- Base URL: `https://friends.roblox.com`
- URL: `https://friends.roblox.com/v1/my/trusted-friends/candidates`
- Auth: API key in cookie `.ROBLOSECURITY`

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

OK

- RobloxPagingCursoredPagedResultRobloxFriendsApiModelsResponseTrustedFriendCandidateResponse
  - `PreviousCursor` string
  - `PageItems` RobloxFriendsApiModelsResponseTrustedFriendCandidateResponse[]
    - `userId` integer: The friend's user Id.
    - `state` string: The trusted friend request state between the authenticated user and this friend: None, RequestSent, or RequestReceived.
  - `NextCursor` string
  - `HasMore` boolean

## Other responses

- `400`: 34: Invalid pagination cursor. 44: Invalid count, Allowed values: 10, 18, 25, 50, 100
- `401`: 0: Authorization has been denied for this request.
- `500`: 39: There was an internal error processing Trusted Friends.

## Changes

- **2026-11-13** `c2ba38e6ba62`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/my/trusted-friends/candidates/get.md)

---

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