Gets a virtual item by SKU for building a catalog.
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_sku required | string Item SKU. Example: booster_mega_1 |
locale | string Default: "en" Response language. Two-letter lowercase language code per ISO 639-1. |
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 |
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 |
The virtual item was successfully received.
The item was not found. Make sure the project_id
and the item_sku
are correct.
{- "item_id": 488833,
- "sku": "swords_1",
- "type": "virtual_good",
- "name": {
- "en": "Sword Xsolla Skin"
}, - "description": {
- "en": "Honshu Boshin Wakizashi - Modern Tactical Samurai / Ninja Sword - Hand Forged 1060 Carbon Steel - Full Tang, Fully Functional, Battle Ready - Black TPR, Steel Guard and Pommel"
}, - "price": {
- "amount": 4.99,
- "amount_without_discount": 4.99,
- "currency": "USD"
}, - "virtual_prices": [ ],
- "can_be_bought": true,
- "promotions": [ ],
- "limits": {
- "per_user": {
- "total": 5
}, - "per_item": null,
- "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"
}
], - "attributes": [
- {
- "external_id": "attr_1",
- "name": {
- "en-US": "OK"
}, - "values": [
- {
- "external_id": "val1",
- "value": {
- "en-US": "VALUE"
}
}, - {
- "external_id": "val2",
- "value": {
- "en-US": "VALUE2"
}
}
]
}
], - "is_free": false,
- "groups": [
- {
- "external_id": "weapons",
- "name": {
- "en": "weapons"
}
}
], - "virtual_item_type": "non_consumable",
- "vp_rewards": [ ],
- "inventory_options": {
- "consumable": false,
- "expiration_period": null
}, - "custom_attributes": {
- "purchased": 0,
- "attr": "value"
}
}