> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/users/{userId}/profile/settings/people/{userList})

> GET (/users/{userId}/profile/settings/people/{userList})

# GET (/users/{userId}/profile/settings/people/{userList})

Obtiene el perfil de un usuario o varios usuarios, con compatibilidad con People Moniker.
El dominio de estos URI es `profile.xboxlive.com`.

* [Comentarios](#ID4EV)
* [Parámetros de URI](#ID4EKB)
* [Parámetros de cadena de consulta](#ID4EVB)
* [Encabezados de solicitud obligatorios](#ID4EQC)
* [Cuerpo de la solicitud](#ID4E2D)

## Comentarios

**userList** y **userIds** son parámetros mutuamente excluyentes. Si se especifican ambos o cualquiera de los dos, obtendrá un **BadRequest** como respuesta. **userList** es una matriz pensada para escenarios futuros en los que resulte útil solicitar varias listas con nombre. **userIds** se compone de cadenas decimales para los XUID: JSON no serializa bien los enteros de 64 bits sin signo. Por último, las configuraciones en XBOX One serán configuraciones con nombre, con nombres normales legibles por personas, en lugar de enteros de 64 bits sin signo o constantes crípticas como **XONLINE\_PROFILE\_ASDF**.

## Parámetros de URI

| Parámetro | Tipo | Descripción |
| - | - | - |
| userId | string | Puede ser 'xuid(12345)', 'gt(myGamertag)' o 'me'. |
| userList | string | Lista con nombre de personas para las que se obtienen las configuraciones. Actualmente, People es la única lista admitida. |

## Parámetros de cadena de consulta

\| Parámetro| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- |
\| settings| string| Lista de nombres de configuraciones delimitados por comas.|

## Encabezados de solicitud obligatorios

\| Encabezado| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| Entero de 32 bits con signo| Valor = 2|
\| content-type| string| Valor = `application/json`|

## Cuerpo de la solicitud

### Ejemplo de solicitud

```cpp theme={null}
GET /users/me/profile/settings/people/people?settings=GameDisplayName,GameDisplayPicRaw,Gamerscore,Gamertag
      
```

##### Cuerpo de la respuesta

La respuesta es un objeto **ReadMultiSettingsResponseV2**. Suponiendo que el usuario que realiza la llamada solo tiene un amigo:

```cpp theme={null}
{
      "profileUsers":[
         {
            "id":"2533274791381930",
            "settings":[
               {
                  "id":"GameDisplayName",
                  "value":"John Smith"
               },
               {
                  "id":"GameDisplayPicRaw",
                  "value":"http://images-eds.xboxlive.com/image?url=z951ykn43p4FqWbbFvR2Ec.8vbDhj8G2Xe7JngaTToBrrCmIEEXHC9UNrdJ6P7KIN0gxC2r1YECCd3mf2w1FDdmFCpSokJWa2z7xtVrlzOyVSc6pPRdWEXmYtpS2xE4F&format=png&w=64&h=64"
               },
               {
                  "id":"Gamerscore",
                  "value":"0"
               },
               {
                  "id":"Gamertag",
                  "value":"CracklierJewel9"
               }
            ]
         }
      ]
   }
         
```

## Consulte también

##### Elemento primario

[/users/{userId}/profile/settings/people/{userList}?settings={settings}](https://docs.xbox.com/es/reference/live/rest/uri/profileV2/uri-usersuseridprofilesettingspeopleuserlist.md)

[Profile (JSON)](https://docs.xbox.com/es/reference/live/rest/json/json-profile.md)


## Related topics

- [/users/{userId}/profile/settings/people/{userList}?settings={settings}](https://docs.xbox.com/es/reference/live/rest/uri/profileV2/uri-usersuseridprofilesettingspeopleuserlist.md)
- [GET (/users/{ownerId}/people/mute)](https://docs.xbox.com/es/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemuteget.md)
- [GET (/users/{ownerId}/people/avoid)](https://docs.xbox.com/es/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoidget.md)
- [GET (/users/{ownerId}/people/{targetid})](https://docs.xbox.com/es/reference/live/rest/uri/people/uri-usersowneridpeopletargetidget.md)
- [XblProfileGetUserProfilesForSocialGroupAsync](https://docs.xbox.com/es/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupasync.md)