# Получение списка игр, принадлежащих пользователю

Get the list of games owned by the user. The response will contain an array of games owned by a particular user.

  Attention
    All projects have the limitation to the number of items that you can
    get in the response. The default and maximum value is 50 items
    per response. To get more data page by page, use limit
    and offset fields.
  
  Note
    This API call returns generic item catalog data when used without
    authorization. Use authorization to retrieve
    personalized
    user data, such as limits and promotions associated with the item.
    To do this, pass the user JWT in the Authorization header.
    For more information about user JWT, see the Security block
    for this call.

Endpoint: GET /v2/project/{project_id}/entitlement
Version: 2.0.0
Security: XsollaLoginUserJWT

## Path parameters:

  - `project_id` (integer, required)
    Project ID. You can find this parameter in your Publisher Account next to the project name and in the browser address bar when working with a project. The URL has the following format: https://publisher.xsolla.com//projects/.
    Example: 44056

## Query parameters:

  - `limit` (integer)
    Лимит количества элементов на странице.
    Example: 50

  - `offset` (integer)
    Номер элемента, с которого выполняется вывод на странице (нумерация ведется с 0).

  - `sandbox` (integer)
    Какой тип прав владения должен быть возвращен. Если параметру присвоено значение 1, возвращаются права владения, полученные пользователем только в режиме тестового окружения. Если параметр не передан или установлен в 0, возвращаются права владения, полученные пользователем только в режиме боевого окружения.

  - `additional_fields[]` (array)
    Список дополнительных полей. Эти поля будут в ответе, если вы отправите их в своем запросе. Доступные поля: attributes.

## Response 200 fields (application/json):

  - `has_more` (boolean)
    Используется как индикатор того, что остались еще страницы.

  - `items` (array)

  - `items.attributes` (array)
    Список атрибутов и их значений, соответствующих игре.

Внимание. Эта часть ответа доступна только при отправке параметра запроса additional_fields[]=attributes.

  - `items.attributes.external_id` (string)
    Уникальный ID атрибута. external_id может содержать только строчные и заглавные латинские буквы, цифры, тире и подчеркивания.

  - `items.attributes.name` (string)
    Название атрибута.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    Уникальный ID значения атрибута. external_id может содержать только строчные латинские буквы, цифры, тире и подчеркивания.

  - `items.attributes.values.value` (string)
    Значение атрибута.
    Example: "Strategy"

  - `items.description` (string)
    Описание игрового пакета.

  - `items.drm` (string)
    Уникальный ID платформы.
    Enum: "steam", "playstation", "xbox", "uplay", "origin", "drmfree", "gog", "epicgames", "nintendo_eshop", "discord_game_store", "oculus", "rockstar", "viveport", "stadia"

  - `items.game_sku` (string)
    Уникальный ID пакета ключей.

  - `items.image_url` (string)
    URL-адрес изображения.

  - `items.is_pre_order` (boolean)
    Находится ли игра в статусе предзаказа.

  - `items.name` (string)
    Название игрового пакета.

  - `items.project_id` (integer)
    ID проекта. Вы можете найти этот параметр в [Личном кабинете](https://publisher.xsolla.com/) рядом с названием проекта.

  - `total_items_count` (integer)
    Общее количество игр, которыми владеет пользователь.

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401