ROBLOX API

Assets

GET /assets/{id}/versions

Retrieves asset information for the specified asset ID. The authenticated user must be able to manage the asset.
Parameters
id long The ID of the asset.
placeId no type! The ID of the place.
page int (Optional)The page to retrieve.
Returns
[{ "Id":536133191, "AssetId":226132918, "VersionNumber":3, "RawContentId":2619739106, "ParentAssetVersionId":536132109, "CreatorType":1, "CreatorTargetId":80502178, "CreatingUniverseId":null, "Created":"2015-07-13T11:51:12.9073098-05:00", "Updated":"2015-07-13T11:51:12.9073098-05:00" }]
Response Error
409 For PlatformException

POST /assets/award-badge

Award a badge to a user.
Parameters
userId int The ID of the user.
badgeId long The ID of the badge.
placeId long The ID of the place.
Returns
{userName} won {badgeCreatorName}'s "{badgeName}" award! (if successful)
Response Error
0 Platform exception

Currency

GET /currency/balance

Returns the Robux and Ticket balances for the currently authenticated user.
Returns
{ "robux":10 }
Response Error
ApplicationException: Invalid auth token

Friends

GET /users/{userId}/friends

Retrieves a paged list of friends for the specified user.
Parameters
userId long The ID of the user.
page int (Optional) The page to retrieve.
Returns
[{ "Id":12345678, "Username":"user", "AvatarUri":"", "AvatarFinal":true, "IsOnline":true }]

POST /user/accept-friend-request

Accept a friend request.
Parameters
requesterUserId int The ID of the requester.
Returns
{ "success":true, "message":"Success" }
Response Error
400 Bad Request: Invalid requesterUserId
404 Resource Not found: Not enabled

POST /user/decline-friend-request

Decline a friend request.
Parameters
requesterUserId int The ID of the requester.
Returns
{ "success":true, "message":"Success" }
Response Error
400 Bad Request: Invalid requesterUserId
404 Resource Not Found: Not enabled

POST /user/request-friendship

Send a friend request to the specified user.
Parameters
recipientUserId long The userId of the recipient.
Returns
{ "success":true, "message":"Success" }
Response Error
400 Bad Request: Invalid recipientUserId
404 Resource Not Found: Not enabled

GET /user/get-friendship-count

Get number of friends.
Parameters
userId long? (Optional)The ID of the user, or the ID of the autheticated user if not provided.
Returns
{ "success":true, "message":"Success", "count":10 }
Response Error
404 Resource Not Found: Not enabled

POST /user/unfriend

UnFriend a user
Parameters
friendUserId int The ID of the friend.
Returns
{ "success":true, "message":"Success" }
Response Error
400 Bad Request: Invalid friendUserId
404 Not Found: Not enabled

GET /user/following-exists

Returns whether followerUserId is following userId
Parameters
userId long The user potentially being followed
followerUserId long The user potentially following the other user
Returns
{ "success":true, "message":"Success", "isFollowing":true }
Response Error
400 Bad Request:Invalid followerUserId/Invalid userId
404 Not Found: Not enabled

POST /user/follow

Follow a particular user
Parameters
followedUserId long The ID of the user to follow.
Returns
{ "success":true, "message":"Success" }
Response Error
400 Invalid followerUserId
403 Block exists between authenticated user and followedUserId
404 Not enabled

POST /user/unfollow

UnFollow a particular user
Parameters
followedUserId long The ID of the followed user.
Returns
{ "success":true, "message":"Success" }
Response Error
400 Invalid followerUserId
404 Not enabled

Groups

GET /users/{userId}/groups

Lists a user's groups.
Parameters
userId int The ID of the user.
Returns
[{ "Id": 696519, "Name": "Orinthians", "EmblemId": 135321582, "EmblemUrl": "http://www.roblox.com/asset/?id=135321582", "Rank": 254, "Role": "Council", "IsInClan": false, "IsPrimary": false }, { "Id": 679727, "Name": "ROBLOX Community Staff and Forum Users", "EmblemId": 90708870, "EmblemUrl": "http://www.roblox.com/asset/?id=90708870", "Rank": 245, "Role": "Other Staff", "IsInClan": false, "IsPrimary": false }]
Response Error
404 User not found

GET /groups/{groupId}

Retrieves information for the specified group ID.
Parameters
groupId int The ID of the group.
Returns
{ "Name":"Group name", "Id":1234567, "Owner": { "Name":"owner", "Id":12345678 }, "EmblemUrl":"http://www.roblox.com/asset/?id=12345678", "Description":"", "Roles":[{"Name":"Panem Citizens","Rank":1}] }
Response Error
404 Group not found
503 Get group info not enabled

GET /groups/{groupId}/allies

Retrieves a paged list of allied groups.
Parameters
groupId int The ID of the group
page int (Optional) The page to retrieve.
Returns
{ "Groups": [ {"Name":"", "Id":123456, "Owner":{ "Name":"", "Id":23456789 }, "EmblemUrl":"http://www.roblox.com/asset/?id=189284884", "Description":"", "Roles":[{"Name":"Advisor","Rank":1}] } ], "FinalPage":true }

GET /groups/{groupId}/enemies

Retrieves a paged list of enemy groups.
Parameters
groupId int The ID of the group
page int (Optional) The page to retrieve.
Returns
{ "Groups": [ {"Name":"", "Id":123456, "Owner":{ "Name":"", "Id":23456789 }, "EmblemUrl":"http://www.roblox.com/asset/?id=189284884", "Description":"", "Roles":[{"Name":"Advisor","Rank":1}] } ], "FinalPage":true }

IncomingItems

GET /incoming-items/counts

Get number of incoming items.
Returns
{"unreadMessageCount": 1, "friendRequestsCount": 2}
Response Error
403 Forbidden

Marketplace

GET /marketplace/productinfo

Returns the product info for the specified asset.
Parameters
assetId long The ID of the asset.
Returns
{ "TargetId":123456789, "ProductType":"User Product", "AssetId":123456789, "ProductId":24870409, "Name":"Hat", "Description":"", "AssetTypeId":8, "Creator":{"Id":1,"Name":"ROBLOX"}, "IconImageAssetId":0, "Created":"2015-06-25T20:07:49.147Z", "Updated":"2015-07-11T20:07:51.863Z", "PriceInRobux":350, "PriceInTickets":null, "Sales":0, "IsNew":true, "IsForSale":true, "IsPublicDomain":false, "IsLimited":false, "IsLimitedUnique":false, "Remaining":null, "MinimumMembershipLevel":0, "ContentRatingTypeId":0 }

GET /marketplace/game-pass-product-info

Returns the product info for the specified game pass.
Parameters
gamePassId long The ID of the asset.
Returns
{ "TargetId":123456789, "ProductType":"Game Pass", "AssetId":123456789, "ProductId":24870409, "Name":"Hat", "Description":"", "AssetTypeId":8, "Creator":{"Id":1,"Name":"ROBLOX"}, "IconImageAssetId":0, "Created":"2015-06-25T20:07:49.147Z", "Updated":"2015-07-11T20:07:51.863Z", "PriceInRobux":350, "PriceInTickets":null, "Sales":0, "IsNew":true, "IsForSale":true, "IsPublicDomain":false, "IsLimited":false, "IsLimitedUnique":false, "Remaining":null, "MinimumMembershipLevel":0, "ContentRatingTypeId":0 }

Ownership

GET /ownership/hasasset

Checks if a user owns the specified asset.
Parameters
userId int The ID of the user.
assetId long The ID of the asset.
Returns
true/false

Reference

GET /reference/deviceinfo

Get device info.
Returns
{ "PlatformType": "platform name", "DeviceType": "device type", "OperatingSystemType": "OS type" }

UserBlock

POST /userblock/block

Block a user; prevent communication between the current user and the user specified.
Parameters
userId int UserId of the user to be blocked
Returns
{ "success":true }
Response Error
400 Bad Request: Invalid user id

POST /userblock/unblock

Unblock a user; allow communication between the current user and the user specified.
Parameters
userId int UserId of the user to be unblocked
Returns
{ "success":true }
Response Error
400 Bad Request: Invalid user id

Users

GET /users/{userId}

Retrieves user information for the specified user ID.
Parameters
userId int The ID of the user.
Returns
{ "Id": 12345678, "Username": "user name" }

GET /users/get-by-username

Retrieves user information for the specified username.
Parameters
username string The name of the user.
Returns
{"Id": 12345678, "Username":"user name"}
Response Error
Invalid username
User not found

GET /users/{userId}/canmanage/{assetId}

Returns whether the user can manage a given asset.
Parameters
userId int The ID of the user.
assetId long The ID of the asset.
Returns
{ "Success": true, "CanManage": false }
Response Error
Not enabled
Unknown user or asset