List a SKU's stock ledger
GET/v2/experiences/{experienceId}/retail-skus/{skuId}/stock-movements
Requires your API key in the X-API-Key header.
Returns the SKU's stock history, newest first: restocks, manual removals, sales (recorded when an order is confirmed) and returns (recorded when a sold line is cancelled). Organizer only (403 otherwise).
curl "https://api.turneo.co/v2/experiences/8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f/retail-skus/8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d/stock-movements" \
-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
Query parameters
pageintegerPage number to return (1-based).
- Default:
1- Example:
1
page_sizeintegerNumber of entries per page (default 50).
- Default:
50- Example:
50
nopaginationbooleanWhen
true, disables pagination and returns all entries in a plain array.- Example:
false
Responses
200object
Paginated stock ledger, newest first.
countintegerTotal number of entries.
- Example:
34
nextstring (uri)nullableURL of the next page, or null on the last page.
previousstring (uri)nullableURL of the previous page, or null on the first page.
resultsobject[]Ledger entries on this page.
Child fields
idstring (uuid)Entry UUID.
- Example:
5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f8a
deltaintegerChange to the on-hand count; positive for a restock or return, negative for a sale or removal.
- Example:
-1
reasonstringWhy the stock moved.
- Allowed values:
RESTOCKMANUAL_REMOVALSALEREFUND_RETURNCORRECTION- Example:
SALE
actorNamestringnullableAccount that made a manual movement. Null for sales and returns.
- Example:
Hotel Example Shop
retailItemIdstring (uuid)nullableThe retail item a
SALEorREFUND_RETURNentry came from.- Example:
7d1e2f3a-4b5c-4d6e-8f9a-0b1c2d3e4f5a
notestringnullableNote recorded with a manual movement.
- Example:
Delivery from supplier
createdAtstring (date-time)When the movement was recorded.
- Example:
2026-07-15T09:12:00Z
{
"count": 34,
"next": null,
"previous": null,
"results": [
{
"id": "5d6e7f8a-9b0c-4d1e-8f2a-3b4c5d6e7f8a",
"delta": -1,
"reason": "SALE",
"actorName": "Hotel Example Shop",
"retailItemId": "7d1e2f3a-4b5c-4d6e-8f9a-0b1c2d3e4f5a",
"note": "Delivery from supplier",
"createdAt": "2026-07-15T09:12:00Z"
}
]
}Errors
- 401
Missing or invalid
X-API-Keyheader.- 403
The API key is valid but not allowed to perform this action on this resource.
- 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."
}
]
}