Get games list by specified group

get/v2/project/{project_id}/items/game/group/{external_id}

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.

SecurityAuthForClient

Request

path Parameters

project_id required	integer Project ID. Example: 44056
external_id required	string Default: "all" Group external ID.

query Parameters

limit	integer Limit for the number of elements on the page. Example: limit=50
offset	integer Number of the element from which the list is generated (the count starts from 0). Example: offset=0
locale	string Default: "en" Response language. Two-letter lowercase language code per ISO 639-1.
additional_fields[]	Array of strings 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 Default: "US" 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.

Responses

200

The list of games was successfully received.

Request samples

Response samples

application/json

{"items": [{"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
}
]
}
]
}