Get game by ID (admin)

project_id required	integer Project ID. You can find this parameter in your Publisher Account next to the name of the project. Example: 44056
item_id required	string Item ID. Example: 656

query Parameters

promo_code

string [ 1 .. 128 ] characters

Unique case sensitive code. Contains letters and numbers.

Example: promo_code=WINTER2021

Responses

200

Game was successfully received.

401

Basic authentication not passed or wrong. Make sure you used basic authentication or correct credentials.

404

Game not found.

Request samples

curl -i -X GET \
  -u <merchant_id_or_project_id>:<api_key> \
  'https://store.xsolla.com/api/v2/project/{project_id}/admin/items/game/id/{item_id}?promo_code=WINTER2021'

Response samples

application/json

{"item_id": 1,
"sku": "com.xsolla.game_1",
"type": "unit",
"name": {"en": "Game 1"
},
"description": {"en": "Example game 1"
},
"long_description": {"en": "Example game's long description"
},
"image_url": "https://image.example.com",
"media_list": [{"type": "image",
"url": "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"
}
],
"order": 1,
"groups": [{"external_id": "horror",
"name": {"en": "Horror"
}
}
],
"attributes": [{"external_id": "platform",
"name": {"en-US": "Platform"
},
"values": [{"external_id": "platform_value_d847f9a494487f5e95ad218f7beecac646f15989",
"value": {"en-US": "Windows, Linux",
"de-DE": "Windows, Linux"
}
}
]
}
],
"is_free": false,
"is_enabled": true,
"is_show_in_store": false,
"unit_items": [{"item_id": 3,
"sku": "com.xsolla.game_1_key_1",
"type": "game_key",
"is_free": false,
"prices": [{"amount": 1199.99,
"currency": "RUB",
"is_default": true,
"is_enabled": true,
"country_iso": "RU"
}
],
"virtual_prices": [ ],
"order": 1,
"is_enabled": true,
"is_show_in_store": false,
"drm_name": "Steam",
"drm_sku": "steam_key_1",
"drm_image": "https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png",
"drm_id": 1,
"keys": {"available": 3,
"total": 4,
"used": 1
},
"is_sales_exist": false,
"pre_order": {"release_date": null,
"is_enabled": false,
"description": null
},
"limits": {"per_user": {"total": 5
},
"per_item": {"total": 10000,
"available": 5000,
"reserved": 500,
"sold": 4500
},
"recurrent_schedule": {"per_user": {"interval_type": "daily",
"day_of_week": null,
"day_of_month": null,
"time": "11:00:00+08:00",
"reset_next_date": 1677553200,
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00"
}
}
},
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
]
},
{"item_id": 4,
"sku": "com.xsolla.game_1_key_2",
"type": "game_key",
"is_free": false,
"prices": [{"amount": 1299.99,
"currency": "RUB",
"is_default": true,
"is_enabled": true,
"country_iso": "RU"
}
],
"virtual_prices": null,
"order": 1,
"is_enabled": true,
"is_show_in_store": false,
"drm_name": "Epic Games Store",
"drm_sku": "epicgames_key_1",
"drm_image": null,
"drm_id": 8,
"keys": {"available": 0,
"total": 0,
"used": 0
},
"is_sales_exist": false,
"pre_order": {"release_date": "2020-08-11T10:00:00+03:00",
"is_enabled": true,
"description": null
},
"regions": [{"id": 12
},
{"id": 64
}
],
"limits": {"per_user": null,
"per_item": null,
"recurrent_schedule": null
},
"periods": [{"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
]
}
]
}