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

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

ВниманиеВсе проекты имеют ограничение на количество товаров, которые вы можете получить в ответе. Значение по умолчанию и максимальное значение — 50 товаров на ответ.Чтобы получить больше данных постранично, используйте поля limit и offset.

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

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.
    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)
    Используется как индикатор того, что остались еще страницы.
    Example: true

  - `items` (array)

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

Внимание. Эта часть ответа доступна только при отправке параметра запроса additional_fields[]=attributes.
    Example: {"value":{"external_id":"genre","name":"Жанр","values":[{"external_id":"genre_e3364991f92e751689a68b96598a5a5a84010b85","value":"Casual"},{"external_id":"genre_eba07bfd0f982940773cba3744d97264dd58acd7","value":"Strategy"},{"external_id":"genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8","value":"Mobile"}]}}

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

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

  - `items.attributes.values` (array)

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

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

  - `items.description` (string)
    Описание игрового пакета.
    Example: "Description of the greatest game in the world."

  - `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 пакета ключей.
    Example: "theGreatestGameSku"

  - `items.image_url` (string)
    URL-адрес изображения.
    Example: "https://none"

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

  - `items.name` (string)
    Название игрового пакета.
    Example: "The Greatest Game in the World"

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

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

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

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

  - `statusCode` (integer)
    Example: 401