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 プロジェクトID。 Example: 44056
external_id required	string Default: "all" グループ外部ID。

query Parameters

limit	integer ページにある要素数の制限。 Example: limit=50
offset	integer リストが生成される要素の番号（0からカウントされる）。 Example: offset=0
locale	string Default: "en" 応答言語。ISO639-1に準拠した2文字の小文字の言語コード。
additional_fields[]	Array of strings 追加フィールドのリスト。これらのフィールドは、リクエストで送信した場合、応答に含まれます。利用可能なフィールド`media_list`、`order`、`long_description`です。
country	string Default: "US" カタログの地域別価格と制限を計算するための国。ISO 3166-1 alpha-2に準拠した2文字の大文字の国コードです。国を明示的に指定しない場合は、ユーザーのIPアドレスに基づいて計算されます。

Responses

200

The list of games was successfully received.

Request samples

Response samples

application/json

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