Skip to main content
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 the 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')));
					  
get friend's presence
get multiple friend's presence
For example: /api/v1/[1234567,8762567,9027469827]/presence
send a conversation
Payload: {"to":"B1GSTACK, xTACTICSx", "message":"Sending you a message from OpenXBL"}
generate a random gamertag
Payload: {"Algorithm":1,"Count":3,"Locale":"en-US","Seed":""}
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
Returns player screenshots metadata
Returns player achievements list
returns specific game achievements. If unsure of TitleId call /achievements first.

More games? use a comma like this: /achievements/100000,200000,300000