Get a SKU
GET/v2/experiences/{experienceId}/retail-skus/{skuId}
Requires your API key in the X-API-Key header.
Returns one SKU with its price, stock and purchase-time questions.
curl "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/retail-skus/8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d" \
-H "X-API-Key: <your-api-key>"Path parameters
experienceIdstring (uuid)requiredUUID of the retail product.
- Example:
8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
skuIdstring (uuid)requiredUUID of the SKU.
- Example:
8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d
Responses
200object
The SKU.
idstring (uuid)SKU UUID. Send it as
retailSkuIdto buy this SKU on an order.- Example:
8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d
skuCodestringnullableYour own stock-keeping code for this SKU.
- Limits:
- up to 64 characters
- Example:
TSHIRT-RED-M
attributeValueIdsstring (uuid)[]The variation values this SKU is made of. Empty for a product without variations.
sortOrderintegerPosition of the SKU in the grid.
- Example:
0
pricestringnullableUnit price as a decimal string, in the organizer's default currency. Null until the SKU is priced.
- Example:
24.00
tracksStockbooleanWhether stock is counted for this SKU. When
falseit sells without limit.- Example:
true
stockQuantityintegernullableUnits on hand. Read-only; it changes through the stock actions, sales and returns. Null until stock is first added. Units held in unconfirmed orders are not subtracted here.
- Example:
12
isEnabledbooleanWhether the SKU is on sale. Can't be
truewhilepriceis null. New SKUs start disabled.- Example:
true
imageIdstring (uuid)nullableThe SKU's own image, chosen from the product's images. Null means the product's first image is shown.
- Example:
3c4d5e6f-7a8b-4c9d-8e1f-2a3b4c5d6e7f
extraFieldsobject[]Questions the buyer answers when buying this SKU.
Child fields
idstring (uuid)Question UUID. Answers are keyed by it.
- Example:
aa1bb2cc-3dd4-4ee5-9ff6-0a1b2c3d4e5f
namestring or map of stringMultilingual text field. Stored as an object keyed by language code (
en,de,it,es,fr,hr,sl,pt,zh,zh-hant,ja,ko,ru; machine translations are stored under<lang>_autokeys internally). On read it is returned as a single string resolved for the requestedlanguage(falling back to English when the object is not consistently translated), or as the full per-language object whenshowTranslations=trueis passed. On write, either a plain string (stored as English) or a partial per-language object is accepted.Accepted shapes
Either string
Or map of string
sortOrderintegerOrder the questions are asked in.
- Example:
0
fieldTypestringQUESTIONtakes free text;CHECKBOXtakes"true"or"false".- Allowed values:
QUESTIONCHECKBOX- Example:
QUESTION
requiredbooleanWhether the question must be answered before the order can be confirmed. A required
CHECKBOXmust be ticked.- Example:
false
{
"id": "8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d",
"skuCode": "TSHIRT-RED-M",
"attributeValueIds": [
"9a8b7c6d-5e4f-4a3b-8c1d-0e9f8a7b6c5d"
],
"sortOrder": 0,
"price": "24.00",
"tracksStock": true,
"stockQuantity": 12,
"isEnabled": true,
"imageId": "3c4d5e6f-7a8b-4c9d-8e1f-2a3b4c5d6e7f",
"extraFields": [
{
"id": "aa1bb2cc-3dd4-4ee5-9ff6-0a1b2c3d4e5f",
"name": "Sunset Kayak Tour",
"sortOrder": 0,
"fieldType": "QUESTION",
"required": false
}
]
}Errors
- 401
Missing or invalid
X-API-Keyheader.- 404
The resource does not exist or belongs to another partner (existence is not leaked across partners).
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}