> ## 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/me/inventory)

> GET (/users/me/inventory)

# GET (/users/me/inventory)

Proporciona al autor de la llamada el conjunto de inventario asociado actualmente al usuario proporcionado.
El dominio de estos URI es `inventory.xboxlive.com`.

* [Comentarios](#ID4EV)
* [Parámetros de cadena de consulta](#ID4EHB)
* [Ejemplo de solicitud](#ID4EDE)
* [Cuerpo de la respuesta](#ID4ERE)

## Comentarios

No se realizará ninguna comprobación de directivas, aplicación ni filtrado como parte de esta llamada. Los autores de la llamada tienen la opción de pasar parámetros de consulta para restringir el ámbito de los resultados devueltos.

Los autores de la llamada pueden paginar los resultados con un token de continuación proporcionado en una respuesta anterior: **/users/me/inventory?continuationToken=continuationTokenString**.

El autor de la llamada puede realizar una llamada a la API de detalles con una dirección URL de elemento específica para ver información sobre un elemento específico.

## Parámetros de cadena de consulta

| Parámetro | Tipo | Descripción |
| - | - | - |
| availability | string | La disponibilidad actual de los elementos que se van a devolver. El valor predeterminado es "Available", que devuelve los elementos para los que la fecha actual se encuentra entre la fecha de inicio y la fecha de finalización. Otros valores son "All", que devuelve todos los elementos, y "Unavailable", que devuelve los elementos para los que la fecha actual queda fuera del intervalo entre la fecha de inicio y la fecha de finalización y, por lo tanto, no están disponibles actualmente. |
| container | string | Opcional. Si establece el valor en el Id. de producto de un juego, los resultados del inventario solo incluirán los elementos relacionados con ese juego. Esto resulta especialmente útil al llamar al inventario desde el servidor para filtrar los resultados a los productos de un juego específico. |
| expandSatisfyingEntitlements | string | Marca que indica si la respuesta incluye en los resultados devueltos todos los derechos satisfactorios que tiene el usuario. El valor predeterminado es "false". Cuando este parámetro se usa con un valor de "true", cualquier producto concedido al usuario mediante derechos satisfactorios, como elementos agrupados, compras de XBOX 360 migradas a XBOX One, ventajas de suscripción, etc., se agrega a los resultados. Cuando este valor es "false", solo se devuelven en los resultados los elementos primarios, como el ProductID del paquete, y no los elementos individuales incluidos. **Nota:** El uso de este parámetro con un valor de "true" solo se admite si el parámetro itemType no se incluye en el URI; de lo contrario, recibirá un error HTTP 400. |
| productIds | string | Colección de ProductIds que desea recuperar específicamente del inventario del usuario, separados por ','.  Si el usuario no tiene un ProductID proporcionado en los resultados de su inventario, ese elemento no aparecerá en los resultados de la llamada a la API. Si pasa el productID de un paquete junto con el parámetro expandSatisfyingEntitlements establecido en true, todos los elementos incluidos en el paquete se devuelven en los resultados de la llamada (tanto si especificó sus productIds en la cadena de consulta como si no). |
| state | string | El estado de los elementos que se van a devolver. El valor predeterminado es "all", que devuelve todos los elementos. Otros valores son "Enabled", que indica que solo se deben devolver los elementos habilitados; "Suspended", que indica que solo se deben devolver los elementos suspendidos; "Expired", que indica que solo se deben devolver los elementos que hayan expirado; "Cancelled", que indica que solo se deben devolver los elementos cancelados; y "Renewed", que indica que solo se deben devolver los elementos que se hayan renovado. |

Además de estos, el recurso admite los mecanismos de paginación estándar.

## Ejemplo de solicitud

El nombre de dominio completo para este método de URI es `https://inventory.xboxlive.com/users/me/inventory.
		 `

> **Nota:**\
> Los usuarios que se tienen en cuenta dependen del token proporcionado, que puede incluir varios usuarios. Si desea el inventario de un único usuario, también debe proporcionar el hash de usuario del usuario específico que desea considerar de forma exclusiva.

.

## Cuerpo de la respuesta

Si la llamada se realiza correctamente, el servicio devuelve una matriz de elementos de inventario. Consulte [inventoryItem (JSON)](https://docs.xbox.com/es/reference/live/rest/json/json-inventoryitem.md).

### Ejemplo de respuesta

```cpp theme={null}
{
  "pagingInfo": {
    "continuationToken": string,
    "totalItems": int
  },
  "items":
  {
    "url": string,
    "itemType": "Music",
    "titleId": string,
    "containers": string,
    "obtained": DateTime,
    "startDate": DateTime,
    "endDate": DateTime,
    "state": "Enabled"  
}

```

## Consulte también

##### Elemento primario

[/users/me/inventory](https://docs.xbox.com/es/reference/live/rest/uri/marketplace/uri-inventory.md)

##### Información adicional

[Encabezados comunes de EDS](https://docs.xbox.com/es/reference/live/rest/additional/edscommonheaders.md)

[Parámetros de EDS](https://docs.xbox.com/es/reference/live/rest/additional/edsparameters.md)

[Refinadores de consulta de EDS](https://docs.xbox.com/es/reference/live/rest/additional/edsqueryrefiners.md)

[URI de Marketplace](https://docs.xbox.com/es/reference/live/rest/uri/marketplace/atoc-reference-marketplace.md)

[Referencia adicional](https://docs.xbox.com/es/reference/live/rest/additional/atoc-xboxlivews-reference-additional.md)


## Related topics

- [/users/me/inventory](https://docs.xbox.com/es/reference/live/rest/uri/marketplace/uri-inventory.md)
- [GET (/users/me)](https://docs.xbox.com/es/reference/live/rest/uri/presence/uri-usersmeget.md)
- [GET (/users/me/groups/{moniker} )](https://docs.xbox.com/es/reference/live/rest/uri/presence/uri-usersmegroupsmonikerget.md)
- [Get User Inventory](https://docs.xbox.com/api-reference/player-item-management/get-user-inventory.md)
- [/users/me](https://docs.xbox.com/es/reference/live/rest/uri/presence/uri-usersme.md)