Xsolla-logo

Get games listClient-side

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

Gets a games list 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.

Note

In general, the use of catalog of items is available without authorization.
Only authorized users can get a personalized catalog.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

Project ID. You can find this parameter in your Publisher Account next to the name of the project.

Example: 44056
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.

Items Enum: "media_list" "order" "long_description" "custom_attributes"
country
string

Two-letter uppercase country code per ISO 3166-1 alpha-2. Shows regional prices and restrictions for a catalog if those were specified while creating an item.

Note

If you do not specify the country explicitly, it will be set based on user's IP address.

Example: country=US
promo_code
string [ 1 .. 128 ] characters

Unique case sensitive code. Contains letters and numbers.

Example: promo_code=WINTER2021
show_inactive_time_limited_items
integer
Default: 0

Shows time-limited items that are not available to the user. The validity period of such items has not started or has already expired.

Example: show_inactive_time_limited_items=1
Responses
200

The list of games was successfully received.

Request samples
Response samples
application/json
{
  • "has_more": false,
  • "items": [
    ]
}