This page lists all HTTP APIs for working with friends, such as declining all friend requests or retrieving a friend list. Legacy APIs Legacy APIs with cookie authentication can incorporate breaking changes without notice. We don't recommend them for production applications. Friends v1 Base URLhttps://friends.roblox.comGET/v1/my/friends/countGet the number of friends a user hasGET/v1/my/friends/requestsGet all users that friend requests with targetUserId using exclusive start pagingGET/v1/my/new-friend-requests/countGET/v1/user/friend-requests/countReturn the number of pending friend requests.GET/v1/users/{userId}/friendsGet list of all friends for the specified user.GET/v1/users/{userId}/friends/countGet the number of friends a user hasGET/v1/users/{userId}/friends/findGet a paginated list of all friends for the specified user.GET/v1/users/{userId}/friends/inactiveGet list of inactive friends for the specified user.GET/v1/users/{userId}/friends/onlineGet list of all online friends for the specified user.GET/v1/users/{userId}/friends/searchSearch for friends by name using a text query.GET/v1/users/{userId}/friends/statusesGets a list of friend statuses of specified users against the specified user.POST/v1/contacts/{targetContactId}/request-friendshipSend a contact friend request to target userPOST/v1/user/{userId}/multiget-are-friendsCheck if the requesting user is friends with the specified users.POST/v1/user/friend-requests/decline-allDecline all pending friend requests for the authenticated user.POST/v1/users/{requesterUserId}/accept-friend-requestAccept a friend request.POST/v1/users/{requesterUserId}/decline-friend-requestDecline a friend request.POST/v1/users/{senderUserId}/accept-friend-request-with-tokenAccept a friend request with an Off Network Friending token.POST/v1/users/{targetUserId}/request-friendshipSend a friend request to target userPOST/v1/users/{targetUserId}/unfriendUnfriend a userDELETE/v1/my/new-friend-requestsGET/v1/metadataModelsModels Roblox.Friends.Api.CaptchaStatusResponseModel Roblox.Friends.Api.FollowCountResponse Roblox.Friends.Api.FollowingExistsRequestModel Roblox.Friends.Api.FriendRequest Roblox.Friends.Api.FriendRequestResponse Roblox.Friends.Api.FriendStatusResponse Roblox.Friends.Api.FriendsCountResponse Roblox.Friends.Api.FriendshipRequestModel Roblox.Friends.Api.Models.Request.FriendingTokenRequestModel Roblox.Friends.Api.Models.Response.ClearNewFriendRequestResponse Roblox.Friends.Api.Models.Response.DeclineAllFriendRequestsResponse Roblox.Friends.Api.Models.Response.FollowingExistsResponse Roblox.Friends.Api.Models.Response.FollowingExistsResponseModel Roblox.Friends.Api.Models.Response.FriendResponse Roblox.Friends.Api.Models.Response.FriendsPageMetadataResponse Roblox.Friends.Api.Models.Response.NewFriendRequestsCountResponse Roblox.Friends.Api.Models.Response.UserPresenceResponse Roblox.Friends.Api.Models.Response.UserPresenceResponseModel Roblox.Friends.Api.Models.Response.UserResponse Roblox.Friends.Api.MultigetAreFriendsRequestModel Roblox.Friends.Api.MultigetAreFriendsResponse Roblox.Friends.Api.PendingFriendRequestCountModel Roblox.Paging.CursoredPagedResult[Roblox.Friends.Api.Models.Response.FriendResponse] Roblox.Paging.ExclusiveStartKeyCursor[System.String] Roblox.Platform.Core.ExclusiveStartPaging.IExclusiveStartKeyInfo[Roblox.Web.Friends.FriendRequestsPlatformExclusiveStartKey] Roblox.Platform.Core.ExclusiveStartPaging.IExclusiveStartKeyInfo[System.Int64] Roblox.Web.Captcha.Models.Request.CaptchaTokenRequest Roblox.Web.WebAPI.ApiEmptyResponseModel Roblox.Web.WebAPI.ExclusiveStartRequest[Roblox.Web.Friends.FriendRequestsPlatformExclusiveStartKey] Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int64] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Friends.Api.FriendStatusResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Friends.Api.Models.Response.UserPresenceResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Friends.Api.Models.Response.UserResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Friends.Api.FriendRequestResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Friends.Api.Models.Response.UserResponse] System.ValueTuple[Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int64],Roblox.Paging.ExclusiveStartKeyCursor[System.String]] View all endpoints for Friends v1 Groups v1 Base URLhttps://groups.roblox.comGET/v1/users/{userId}/friends/groups/rolesGets a list of all groups the specified users' friends are in.ModelsModels Roblox.Groups.Api.ChangeOwnerRequest Roblox.Groups.Api.CreateWallPostRequest Roblox.Groups.Api.GroupAllRolesResponse Roblox.Groups.Api.GroupAuditLogPageResponse[Roblox.Groups.Api.Models.Response.GroupAuditLogResponseItem] Roblox.Groups.Api.GroupConfigurationDisplayOptionsResponse Roblox.Groups.Api.GroupConfigurationResponse Roblox.Groups.Api.GroupDescriptionResponse Roblox.Groups.Api.GroupDetailResponse Roblox.Groups.Api.GroupEconomyPermissionsModel Roblox.Groups.Api.GroupForumsPermissionsModel Roblox.Groups.Api.GroupJoinRequestResponse Roblox.Groups.Api.GroupManagementPermissionsModel Roblox.Groups.Api.GroupMembershipDetailResponse Roblox.Groups.Api.GroupMembershipMetadataResponse Roblox.Groups.Api.GroupMembershipPermissionsModel Roblox.Groups.Api.GroupNameChangeConfigurationResponse Roblox.Groups.Api.GroupNotificationPreferenceData Roblox.Groups.Api.GroupOpenCloudPermissionsModel Roblox.Groups.Api.GroupPayoutResponse Roblox.Groups.Api.GroupPayoutRestrictionResponse Roblox.Groups.Api.GroupPermissionsModel Roblox.Groups.Api.GroupPermissionsResponse Roblox.Groups.Api.GroupPoliciesResponse Roblox.Groups.Api.GroupPolicyRequest Roblox.Groups.Api.GroupPolicyResponse Roblox.Groups.Api.GroupPostsPermissionsModel Roblox.Groups.Api.GroupRelationshipsResponse Roblox.Groups.Api.GroupRoleDetailResponse Roblox.Groups.Api.GroupRoleResponse Roblox.Groups.Api.GroupSearchMetadataResponse Roblox.Groups.Api.GroupSearchPageResponse Roblox.Groups.Api.GroupSearchResponseItem Roblox.Groups.Api.GroupSettingsResponse Roblox.Groups.Api.GroupsDisplayOptionsResponse Roblox.Groups.Api.JoinGroupRequest Roblox.Groups.Api.MembersRequest Roblox.Groups.Api.Models.Request.CreateRoleSetRequest Roblox.Groups.Api.Models.Request.UpdateRoleSetRequest Roblox.Groups.Api.Models.Response.GroupAuditLogResponseItem Roblox.Groups.Api.Models.Response.GroupNameHistoryResponseItem Roblox.Groups.Api.Models.Response.GroupWallPostModel Roblox.Groups.Api.Models.Response.UserModel Roblox.Groups.Api.PayoutRecipientRequest Roblox.Groups.Api.PayoutRequest Roblox.Groups.Api.PostGroupStatusRequest Roblox.Groups.Api.PrimaryGroupRequest Roblox.Groups.Api.RecurringPayoutsConfigurationResponse Roblox.Groups.Api.RelationshipsRequest Roblox.Groups.Api.RoleConfigurationResponse Roblox.Groups.Api.ShoutResponse Roblox.Groups.Api.SocialLinkRequest Roblox.Groups.Api.SocialLinkResponse Roblox.Groups.Api.UpdateGroupDescriptionRequest Roblox.Groups.Api.UpdateGroupNameRequest Roblox.Groups.Api.UpdateGroupNameResponse Roblox.Groups.Api.UpdateGroupNotificationPreferenceRequest Roblox.Groups.Api.UpdateGroupSettingsRequest Roblox.Groups.Api.UpdatePermissionsRequest Roblox.Groups.Api.UpdateUserRoleRequest Roblox.Groups.Api.UserGroupMembershipResponse Roblox.Groups.Api.UserGroupRoleResponse Roblox.Groups.Client.GroupFeaturedContentResponse Roblox.Paging.ExclusiveStartKeyCursor[System.String] Roblox.Paging.StartIndexCursor Roblox.Platform.Core.ExclusiveStartPaging.IExclusiveStartKeyInfo[System.Int32] Roblox.Platform.Core.ExclusiveStartPaging.IExclusiveStartKeyInfo[System.Int64] Roblox.Web.Responses.Groups.GroupBasicResponse Roblox.Web.Responses.Groups.GroupResponseV2 Roblox.Web.Responses.RelatedEntityTypeResponse[Roblox.Web.Responses.Groups.GroupOwnerType] Roblox.Web.WebAPI.ApiEmptyResponseModel Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int32] Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int64] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupDetailResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupMembershipDetailResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupPayoutResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupPermissionsResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.GroupRoleDetailResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.SocialLinkResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Groups.Api.UserGroupMembershipResponse] Roblox.Web.WebAPI.Models.ApiArrayResponse[Roblox.Web.Responses.Groups.GroupBasicResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.GroupJoinRequestResponse] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.Models.Response.GroupNameHistoryResponseItem] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.Models.Response.GroupWallPostModel] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.Models.Response.UserModel] Roblox.Web.WebAPI.Models.ApiPageResponse[Roblox.Groups.Api.UserGroupRoleResponse] Roblox.Web.WebApi.FormData.IUploadedFile System.IO.Stream System.ValueTuple[Roblox.Web.WebAPI.ExclusiveStartRequest[System.Int64],Roblox.Paging.ExclusiveStartKeyCursor[System.String]] View all endpoints for Groups v1 Presence v1 Base URLhttps://presence.roblox.comPOST/v1/presence/usersGet Presence for a list of usersModelsModels Roblox.Presence.Api.Models.Request.UserPresenceRequest Roblox.Presence.Api.Models.Response.UserPresence Roblox.Presence.Api.Models.Response.UserPresencesResponse View all endpoints for Presence v1