# Get games list by specified group

Gets a games list from the specified group for building a catalog.

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.

Endpoint: GET /v2/project/{project_id}/items/game/group/{external_id}
Version: 1.0.0
Security: AuthForClient

## Path parameters:

  - `project_id` (integer, required)
    Project ID.
    Example: 44056

  - `external_id` (string, required)
    Group external ID.

## Query parameters:

  - `limit` (integer)
    Limit for the number of elements on the page.
    Example: 50

  - `offset` (integer)
    Number of the element from which the list is generated (the count starts from 0).

  - `locale` (string)
    Response language. Two-letter lowercase language code per ISO 639-1.

  - `additional_fields[]` (array)
    The list of additional fields. These fields will be in the response if you send them in your request. Available fields media_list, order, long_description.

  - `country` (string)
    Country to calculate regional prices and restrictions for catalog. Two-letter uppercase country code per ISO 3166-1 alpha-2. If you do not specify the country explicitly, it will be calculated based on user's IP address.

## Response 200 fields (application/json):

  - `items` (array)
    Example: [{"sku":"game_1","name":"Game name","groups":[{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla games"}],"type":"unit","unit_type":"game","description":"Game description","image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","attributes":{"$ref":"#/components/examples/client-attribute-game/Catalog_value"},"unit_items":[{"sku":"game_key_01","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"drm_name":"Steam","drm_sku":"steam","has_keys":true,"is_pre_order":true,"release_date":"2020-08-11T10:00:00+03:00"},{"sku":"game_key_02","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"drm_name":"Origin","drm_sku":"origin","has_keys":false,"is_pre_order":false}]},{"sku":"game_2","name":"Game name","groups":[{"external_id":"all","name":"All games"}],"type":"unit","unit_type":"game","description":"Game description","image_url":"https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png","attributes":[{"external_id":"OS","name":"OS","values":[{"external_id":"9d5c5efb7c0f00a00fe4e3583f1215b0050bc723","value":"Windows"}]}],"unit_items":[{"sku":"game_key_01","type":"game_key","is_free":false,"price":{"amount":"30.5","amount_without_discount":"30.5","currency":"USD"},"virtual_prices":[],"drm_name":"Steam","drm_sku":"steam","has_keys":false,"is_pre_order":false}]}]

  - `items.sku` (string)
    Unique item ID. The SKU may only contain lowercase Latin alphanumeric characters, periods, dashes, and underscores.
    Example: "game_01"

  - `items.name` (string)
    Item name.
    Example: "Game name"

  - `items.groups` (array)
    Groups the item belongs to.
    Example: [{"external_id":"all","name":"All games"},{"external_id":"Xsolla","name":"Xsolla game"}]

  - `items.groups.external_id` (string)
    Example: "accessory"

  - `items.groups.name` (string)
    Example: "Accessory"

  - `items.attributes` (array)
    List of attributes and their values corresponding to the item. Can be used for catalog filtering.

  - `items.attributes.external_id` (string)
    Unique attribute ID. The external_id may only contain lowercase Latin alphanumeric characters, dashes, and underscores.
    Example: "attribute_1"

  - `items.attributes.name` (string)
    Name of attribute.
    Example: "Genre"

  - `items.attributes.values` (array)

  - `items.attributes.values.external_id` (string)
    Unique value ID for an attribute. The external_id may only contain lowercase Latin alphanumeric characters, dashes, and underscores.
    Example: "attribute_value"

  - `items.attributes.values.value` (string)
    Value of attribute.
    Example: "Strategy"

  - `items.type` (string)
    Type of item: virtual_good/virtual_currency/bundle/physical_good/unit.
    Example: "unit"

  - `items.unit_type` (string)
    Type of unit: game.
    Example: "game"

  - `items.description` (string)
    Item description.
    Example: "Game description"

  - `items.image_url` (string)
    Image URL.
    Example: "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png"

  - `items.unit_items` (array)

  - `items.unit_items.type` (string)
    Type of item: game_key.
    Example: "game_key"

  - `items.unit_items.is_free` (boolean)
    If true, the item is free.

  - `items.unit_items.price` (object)
    Item prices.

  - `items.unit_items.price.amount` (string)
    Discounted item price.
    Example: "2.9900"

  - `items.unit_items.price.amount_without_discount` (string)
    Item price.
    Example: "2.9900"

  - `items.unit_items.price.currency` (string)
    Default purchase currency. Three-letter code per [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).
    Example: "USD"

  - `items.unit_items.virtual_prices` (array)
    Virtual prices.

  - `items.unit_items.virtual_prices.amount` (integer)
    Discounted item price in virtual currency.
    Example: 100

  - `items.unit_items.virtual_prices.sku` (string)
    Virtual currency item SKU.
    Example: "vc_test"

  - `items.unit_items.virtual_prices.is_default` (boolean)
    Whether price is default for item.
    Example: true

  - `items.unit_items.virtual_prices.image_url` (string)
    Image of virtual currency.
    Example: "http://image.png"

  - `items.unit_items.virtual_prices.name` (string)
    Virtual currency name.
    Example: "SHOTGUN FOR TRUE RAIDERS"

  - `items.unit_items.virtual_prices.type` (string)
    Virtual currency type.
    Example: "virtual_currency"

  - `items.unit_items.virtual_prices.description` (string)
    Virtual currency description.
    Example: "Big Rocket - description"

  - `items.unit_items.drm_name` (string)
    DRM name.
    Example: "Steam"

  - `items.unit_items.drm_sku` (string)
    Unique DRM ID. The SKU may only contain lowercase Latin alphanumeric characters, periods, dashes, and underscores.
    Example: "steam"

  - `items.unit_items.has_keys` (boolean)
    If true, the game key has keys for sale.

  - `items.unit_items.is_pre_order` (boolean)
    If true, the game key is pre-order and the release date hasn't passed.
    Example: true

  - `items.unit_items.release_date` (string)
    Game key release date in the ISO 8601 format.
    Example: "2020-08-11T10:00:00+03:00"