Skip to main content

GET (/users/xuid()/achievements//)

Gets the details of the Achievement. The domain for these URIs is achievements.xboxlive.com.

URI parameters

Authorization

Authorization claims used | Claim| Required?| Description| Behavior if missing| | --- | --- | --- | --- | --- | --- | --- | | User| Yes| A valid user on XBOX LIVE for whom the request is being made.| 403 Forbidden| | Title| No| The calling title.| Depends on AuthZ. As of May 1, 2013, AuthZ does not supply a claim when missing and will therefore deny access to any SCIDs not marked as public.| | Sandbox| No| The sandbox from which the results should be retrieved.| Depends on AuthZ. As of May 1, 2013, AuthZ does not supply a default claim when missing.|

Effect of privacy settings on resource

Effect of Privacy Settings on Resource | Requesting User| Target User’s Privacy Setting| Behavior| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | me| -| As described.| | friend| everyone| OK| | friend| friends only| OK| | friend| blocked| Forbidden.| | non-friend user| everyone| OK| | non-friend user| friends only| Forbidden.| | non-friend user| blocked| Forbidden.| | third-party site| everyone| OK| | third-party site| friends only| Forbidden.| | third-party site| blocked| Forbidden.|

Required Request Headers

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| Authentication credentials for HTTP authentication. Example value: “XBL3.0 x=<userhash>;<token>”.|

Optional Request Headers

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| string| Build name/number of the XBOX LIVE service to which this request should be directed. The request will only be routed to that service after verifying the validity of the header, the claims in the auth token, and so on. Default value: 1.| | x-xbl-contract-version| string| Defaults to V1.| | Accept-Language| string| List of desired locales and fallbacks (e.g., fr-FR, fr, en-GB, en-WW, en-US). The Achievements service will work through the list until it finds matching localized strings. If none are found, it attempts to match the location defined in the user token, which comes from the user’s IP address. If still no matching localized strings are found, it uses the default strings provided by the title developer/publisher. |

Request body

No objects are sent in the body of this request.

HTTP status codes

The service returns one of the status codes in this section in response to a request made with this method on this resource. For a complete list of standard HTTP status codes used with XBOX Live Services, see Standard HTTP status codes. | Code| Reason phrase| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| The session was successfully retrieved.| | 301| Moved Permanently| The service has moved to a different URI.| | 307| Temporary Redirect| The URI for this resource has temporarily changed.| | 400| Bad Request| Service could not understand malformed request. Typically an invalid parameter.| | 401| Unauthorized| The request requires user authentication.| | 403| Forbidden| The request is not allowed for the user or service.| | 404| Not Found| The specified resource could not be found.| | 406| Not Acceptable| Resource version is not supported; should be rejected by the MVC layer.| | 408| Request Timeout| The request took too long to complete.| | 410| Gone| The requested resource is no longer available.|

Response body

Sample response

See also

Parent
/users/xuid()/achievements//
Last modified on August 20, 2026