Skip to main content

Get started for free! Sign up here

Instantly get access with 500 requests per hour. Options are available to increase this limit.

Jump right in with these Postman Collections.
basic profile information 

{
	"profileUsers": [
		{
			"id": "2533274700000000",
			"hostId": "2533274700000000",
			"settings": [
				{
					"id": "GameDisplayPicRaw",
					"value": "http://images-eds.xboxlive.com/image?url=wHwbXKif8cus8csoZ03RW_ES.ojiJijNBGRVUbTnZKsoCCCkjlsEJrrMqDkYqs3MBhMLdvWFHLCswKMlApTSbzvES1cjEAVPrczatfOc0jR0Ss4zHEy6ErElLAY8rAVFRNqPmGHxiumHSE9tZRnlghsACzaoisWEww1VSUd9Sx0-&format=png"
				},
				{
					"id": "Gamerscore",
					"value": "18850"
				},
				{
					"id": "Gamertag",
					"value": "xTACTICSx"
				},
				{
					"id": "AccountTier",
					"value": "Gold"
				},
				{
					"id": "XboxOneRep",
					"value": "GoodPlayer"
				},
				{
					"id": "PreferredColor",
					"value": "http://dlassets.xboxlive.com/public/content/ppl/colors/00003.json"
				},
				{
					"id": "RealName",
					"value": "David Regimbal"
				},
				{
					"id": "Bio",
					"value": ""
				},
				{
					"id": "Location",
					"value": "United States"
				}
			],
			"isSponsoredUser": false
		}
	]
}
					  
			          use \OpenXBL\Api;

			          $xbox = new Api('API_KEY');

			          print $xbox->get('account');
another's profile information 

{
	"profileUsers": [
		{
			"id": "2535413400000000",
			"hostId": "2535413400000000",
			"settings": [
				{
					"id": "GameDisplayPicRaw",
					"value": "http://images-eds.xboxlive.com/image?url=wHwbXKif8cus8csoZ03RW_ES.ojiJijNBGRVUbTnZKsoCCCkjlsEJrrMqDkYqs3MBhMLdvWFHLCswKMlApTSbzvES1cjEAVPrczatfOc0jR0Ss4zHEy6ErElLAY8rAVFRNqPmGHxiumHSE9tZRnlghsACzaoisWEww1VSUd9Sx0-&format=png"
				},
				{
					"id": "Gamerscore",
					"value": "6855"
				},
				{
					"id": "Gamertag",
					"value": "OpenXBL"
				},
				{
					"id": "AccountTier",
					"value": "Gold"
				},
				{
					"id": "XboxOneRep",
					"value": "GoodPlayer"
				},
				{
					"id": "PreferredColor",
					"value": "http://dlassets.xboxlive.com/public/content/ppl/colors/00003.json"
				},
				{
					"id": "RealName",
					"value": "David Regimbal"
				},
				{
					"id": "Bio",
					"value": "Xbox Live API"
				},
				{
					"id": "Location",
					"value": "United States"
				}
			],
			"isSponsoredUser": false
		}
	]
}
					  
			          use \OpenXBL\Api;

			          $xbox = new Api('API_KEY');

			          print $xbox->get('account/2535413400000000');
get friends list 

{
	"people": [
		{
			"xuid": "2535413400000000",
			"isFavorite": true,
			"isFollowingCaller": true,
			"isFollowedByCaller": true,
			"isIdentityShared": true,
			"addedDateTimeUtc": "2016-01-03T20:29:06.850124Z",
			"displayName": "OpenXBL",
			"realName": "David Regimbal",
			"displayPicRaw": "http://images-eds.xboxlive.com/image?url=8Oaj9Ryq1G1_p3lLnXlsaZgGzAie6Mnu24_PawYuDYIoH77pJ.X5Z.MqQPibUVTcS9jr0n8i7LY1tL3U7Aiafawv0hvLVTadAYM74jo2GRWfV4isnhJzSvaPwT_5QUO5&format=png",
			"useAvatar": false,
			"gamertag": "OpenXBL",
			"gamerScore": "6855",
			"xboxOneRep": "GoodPlayer",
			"presenceState": "Offline",
			"presenceText": "Offline",
			"presenceDevices": null,
			"isBroadcasting": false,
			"isCloaked": null,
			"isQuarantined": false,
			"suggestion": null,
			"recommendation": null,
			"titleHistory": null,
			"multiplayerSummary": {
				"InMultiplayerSession": 0,
				"InParty": 0
			},
			"recentPlayer": null,
			"follower": null,
			"preferredColor": {
				"primaryColor": "193e91",
				"secondaryColor": "101836",
				"tertiaryColor": "102c69"
			},
			"presenceDetails": null,
			"titlePresence": null,
			"titleSummaries": null,
			"presenceTitleIds": null,
			"detail": null,
			"communityManagerTitles": null,
			"socialManager": {
				"titleIds": [],
				"pages": []
			},
			"broadcast": [],
			"tournamentSummary": null,
			"avatar": null
		},
	],
	"recommendationSummary": null,
	"friendFinderState": null
}
					  
			          use \OpenXBL\Api;

			          $xbox = new Api('API_KEY');

			          print $xbox->get('friends');
get another's friends list 

{
	"people": [
		{
			"xuid": "2535413400000000",
			"isFavorite": true,
			"isFollowingCaller": true,
			"isFollowedByCaller": true,
			"isIdentityShared": true,
			"addedDateTimeUtc": "2016-01-03T20:29:06.850124Z",
			"displayName": "OpenXBL",
			"realName": "David Regimbal",
			"displayPicRaw": "http://images-eds.xboxlive.com/image?url=8Oaj9Ryq1G1_p3lLnXlsaZgGzAie6Mnu24_PawYuDYIoH77pJ.X5Z.MqQPibUVTcS9jr0n8i7LY1tL3U7Aiafawv0hvLVTadAYM74jo2GRWfV4isnhJzSvaPwT_5QUO5&format=png",
			"useAvatar": false,
			"gamertag": "OpenXBL",
			"gamerScore": "6855",
			"xboxOneRep": "GoodPlayer",
			"presenceState": "Offline",
			"presenceText": "Offline",
			"presenceDevices": null,
			"isBroadcasting": false,
			"isCloaked": null,
			"isQuarantined": false,
			"suggestion": null,
			"recommendation": null,
			"titleHistory": null,
			"multiplayerSummary": {
				"InMultiplayerSession": 0,
				"InParty": 0
			},
			"recentPlayer": null,
			"follower": null,
			"preferredColor": {
				"primaryColor": "193e91",
				"secondaryColor": "101836",
				"tertiaryColor": "102c69"
			},
			"presenceDetails": null,
			"titlePresence": null,
			"titleSummaries": null,
			"presenceTitleIds": null,
			"detail": null,
			"communityManagerTitles": null,
			"socialManager": {
				"titleIds": [],
				"pages": []
			},
			"broadcast": [],
			"tournamentSummary": null,
			"avatar": null
		},
	],
	"recommendationSummary": null,
	"friendFinderState": null
}
					  
			          use \OpenXBL\Api;

			          $xbox = new Api('API_KEY');

			          print $xbox->get('friends?xuid={xuid}');
This will add a friend to your list.

200 OK
					  
			          use \OpenXBL\Api;

			          $xbox = new Api('API_KEY');

			          print $xbox->get('friends/add/2535473200000000');
Will remove a friend from your friends list 

200 OK
					  
			          use \OpenXBL\Api;

			          $xbox = new Api('API_KEY');

			          print $xbox->get('friends/remove/2535473200000000');
This will add a friend to your list and mark them as favorite.
Payload: {"xuids":[2535473210914202]} 

200 OK
					  
			          use \OpenXBL\Api;

			          $xbox = new Api('API_KEY');

			          print $xbox->post('friends/favorite', array('xuids' => array('2535473210914202')));
This will remove their favorite status and keep them as friends.
Payload: {"xuids":[2535473210914202]} 

200 OK
					  
			          use \OpenXBL\Api;

			          $xbox = new Api('API_KEY');

			          print $xbox->post('friends/favorite/remove', array('xuids' => array('2535473210914202')));
Lists all recent players.

{
"people": [
  {
"xuid": "2533274828907431",
"isFavorite": false,
"isFollowingCaller": false,
"isFollowedByCaller": false,
"isIdentityShared": false,
"addedDateTimeUtc": null,
"displayName": "StonyLatino101",
"realName": "",
"displayPicRaw": "http://images-eds.xboxlive.com/image?url=8Oaj9Ryq1G1_p3lLnXlsaZgGzAie6Mnu24_PawYuDYIoH77pJ.X5Z.MqQPibUVTcS9jr0n8i7LY1tL3U7AiafR1uC9K9IBEincm3HQNvnsTj3od53NNvB4z1FSrAeTs.&format=png",
"showUserAsAvatar": "0",
"gamertag": "StonyLatino101",
"gamerScore": "91636",
"xboxOneRep": "GoodPlayer",
"presenceState": "Offline",
"presenceText": "Offline",
"presenceDevices": null,
"isBroadcasting": false,
"isCloaked": null,
"isQuarantined": false,
"suggestion": null,
"recommendation": null,
"titleHistory": null,
"multiplayerSummary": {
"InMultiplayerSession": 0,
"InParty": 0
},
"recentPlayer": {
"titles": [
  {
"titleId": "1484511986",
"titleName": "Battlefield 4",
"lastPlayedWithDateTime": "2017-08-19T04:43:17.6293305Z"
}
],
"text": "Last met 1 year ago"
},
"follower": null,
"preferredColor": {
"primaryColor": "677488",
"secondaryColor": "222B38",
"tertiaryColor": "3e4b61"
},
"presenceDetails": null,
"titlePresence": null,
"titleSummaries": null,
"presenceTitleIds": null,
"detail": null,
"communityManagerTitles": null,
"socialManager": {
"titleIds": [],
"pages": [],
},
"broadcast": [],
"tournamentSummary": null,
"avatar": null
},
  {
"xuid": "2533274884674512",
"isFavorite": false,
"isFollowingCaller": false,
"isFollowedByCaller": false,
"isIdentityShared": false,
"addedDateTimeUtc": null,
"displayName": "bugz6unny15",
"realName": "Qwenton Pippen",
"displayPicRaw": "http://images-eds.xboxlive.com/image?url=z951ykn43p4FqWbbFvR2Ec.8vbDhj8G2Xe7JngaTToBrrCmIEEXHC9UNrdJ6P7KIFXxmxGDtE9Vkd62rOpb7JQTCzxmbjUmjf26I9iWDnY.LUElEpm2wN7Xlmymxprvl&format=png",
"showUserAsAvatar": "1",
"gamertag": "bugz6unny15",
"gamerScore": "37665",
"xboxOneRep": "GoodPlayer",
"presenceState": "Online",
"presenceText": "TV",
"presenceDevices": null,
"isBroadcasting": false,
"isCloaked": null,
"isQuarantined": false,
"suggestion": null,
"recommendation": null,
"titleHistory": null,
"multiplayerSummary": {
"InMultiplayerSession": 0,
"InParty": 0
},
"recentPlayer": {
"titles": [
  {
"titleId": "1484511986",
"titleName": "Battlefield 4",
"lastPlayedWithDateTime": "2017-08-19T04:43:17.6293305Z"
}
],
"text": "Last met 1 year ago"
},
"follower": null,
"preferredColor": {
"primaryColor": "e31123",
"secondaryColor": "471010",
"tertiaryColor": "851414"
},
"presenceDetails": null,
"titlePresence": null,
"titleSummaries": null,
"presenceTitleIds": null,
"detail": null,
"communityManagerTitles": null,
"socialManager": {
"titleIds": [],
"pages": [],
},
"broadcast": [],
"tournamentSummary": null,
"avatar": null
},
  {
"xuid": "7036874425499677",
"isFavorite": false,
"isFollowingCaller": false,
"isFollowedByCaller": false,
"isIdentityShared": false,
"addedDateTimeUtc": null,
"displayName": "xTACTICSx(1)",
"realName": "",
"displayPicRaw": "http://images-eds.xboxlive.com/image?url=wHwbXKif8cus8csoZ03RW_ES.ojiJijNBGRVUbTnZKsoCCCkjlsEJrrMqDkYqs3MBhMLdvWFHLCswKMlApTSbzvES1cjEAVPrczatfOc0jR0Ss4zHEy6ErElLAY8rAVFRNqPmGHxiumHSE9tZRnlghsACzaoisWEww1VSUd9Sx0-&format=png",
"showUserAsAvatar": "0",
"gamertag": "xTACTICSx(1)",
"gamerScore": "19060",
"xboxOneRep": "GoodPlayer",
"presenceState": "Offline",
"presenceText": "Offline",
"presenceDevices": null,
"isBroadcasting": false,
"isCloaked": null,
"isQuarantined": false,
"suggestion": null,
"recommendation": null,
"titleHistory": null,
"multiplayerSummary": {
"InMultiplayerSession": 0,
"InParty": 0
},
"recentPlayer": {
"titles": [
  {
"titleId": "345903534",
"titleName": "Minecraft: Xbox One Edition",
"lastPlayedWithDateTime": "2018-05-26T21:50:13.3625415Z"
}
],
"text": "Last met 37 weeks ago"
},
"follower": null,
"preferredColor": {
"primaryColor": "193e91",
"secondaryColor": "101836",
"tertiaryColor": "102c69"
},
"presenceDetails": null,
"titlePresence": null,
"titleSummaries": null,
"presenceTitleIds": null,
"detail": null,
"communityManagerTitles": null,
"socialManager": {
"titleIds": [],
"pages": [],
},
"broadcast": [],
"tournamentSummary": null,
"avatar": null
},
					  
			          use \OpenXBL\Api;

			          $xbox = new Api('API_KEY');

			          print $xbox->get('recent-players');
get friend's presence
get multiple friend's presence
For example: /api/v2/1234567,8762567,9027469827/presence
get message requests
get conversations
get a conversation
send a conversation
Payload: {"xuid": "2533274798000000","message": "This is an example payload."}
Get all group conversations
gets a group chat summary
Get a group chats messages
Create a new message group.
Payload: {"participants":["2535428038000000","2533274802000000"]}
Send text message to group.
Payload: {"groupId":"{groupId}","message":"test message"}
Rename a message group.
Payload: {"groupId":"000000000000000", "name":"Custom Name"}
Invite message group to voice chat.
Payload: {"groupId":"000000000000000"}
Leave a message group.
Payload: {"groupId":"000000000000000"}
Invite to message group.
Payload: {"groupId":"000000000000000", "participants":["00000-xuid-000000000"]}
Kick user from message group.
Payload: {"groupId":"000000000000000", "xuid":"00000-xuid-000000000"}
generate a random gamertag
Payload: {"Algorithm":1,"Count":3,"Locale":"en-US","Seed":""}
Return Club Details/Summary.
Return a list of clubs this user would be interested in joining.
return a list of clubs this user owns and manages.
Create a new club.

Payload: {"name":"Hello World", "type":"[public/private/hidden]"}
Return a list of clubs matching a search query.

q= URL parameter must not be empty.
Check to see if your name is available prior to sending a Create Club request.

Payload: {"name":"Hello World"}
Return your activity feed.
Post a message to your activity feed.
Return your activity feed history.
Return your notifications / alerts. Does not set to 'viewed/seen' status on-request.
Returns basic stats about the player. Basic multiplayer stats as well.
Returns player game clip metadata
Deletes a game clip by returning status 200 OK.
Returns player screenshots metadata
Returns player achievements list
Returns player achievements list
Returns player achievements list
Get user stats for a particular title
returns 150 items at a time. To page more data run /achievements/title/{titleId}/{continuationToken}
returns game achievements history. If unsure of TitleId call /achievements first.

More games? use a comma like this: /achievements/100000,200000,300000
array of sessions the user is currently part of. I.e party chat rooms and their session config. values, summary of users in party.
Invite someone to party chat.

If using this in your application first call "/party" to get a list of sessions (usually only 1) then call this endpoint to invite players to join the session. SessionName below is a value returned from /party

Payload: {"xuid": "000000", "sessionName": ""}

Not finding what you're looking for?

Submit feedback to help make OpenXBL a better place for developers!