Xsolla-logo

Get sellable items list by specified group

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

Gets a sellable items 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.
Request
path Parameters
project_id
required
integer

Project ID.

Example: 59080
external_id
required
string
Default: "armour"

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

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
Responses
200

The list of sellable items from the specified group was successfully received.

404

The group wasn’t found. Make sure that the external_id is correct and the group isn’t turned off or deleted.

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