Xsolla-logoXsolla Developers
or
To Publisher Account

Get codes of promo code promotionServer-sideAdmin

get/v2/project/{project_id}/admin/promocode/{external_id}/code

Gets codes of a promo code promotion.

SecuritybasicAuth
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
external_id
required
integer

Promotion external ID. Unique promotion identifier within the project.

Example: coupon_44056_1
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
Responses
200

List of codes for a promo code was successfully received.

401

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

404

Promo code not found. Make sure the external_id is correct.

Request samples 
curl -i -X GET \
  -u <merchant_id_or_project_id>:<api_key> \
  'https://store.xsolla.com/api/v2/project/{project_id}/admin/promocode/{external_id}/code?limit=50&offset=0'
Response samples
application/json
{
  • "codes": [
    ],
  • "total_count": 5
}
System statusAll services operational

Do Not Sell My Personal Information

Privacy PolicyEnd User License Agreement© 2006–2025 Xsolla Inc.