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).

Requestbash
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)required

    UUID of the retail product.

    Example:
    8e7d6c5b-4a39-4281-90ef-1a2b3c4d5e6f
  • skuIdstring (uuid)required

    UUID of the SKU.

    Example:
    8f14e45f-ceea-4e5b-b0d4-9f3c1a2b3c4d

Query parameters

  • pageinteger

    Page number to return (1-based).

    Default:
    1
    Example:
    1
  • page_sizeinteger

    Number of entries per page (default 50).

    Default:
    50
    Example:
    50
  • nopaginationboolean

    When true, disables pagination and returns all entries in a plain array.

    Example:
    false

Responses

200object

Paginated stock ledger, newest first.

  • countinteger

    Total number of entries.

    Example:
    34
  • nextstring (uri)nullable

    URL of the next page, or null on the last page.

  • previousstring (uri)nullable

    URL 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
    • deltainteger

      Change to the on-hand count; positive for a restock or return, negative for a sale or removal.

      Example:
      -1
    • reasonstring

      Why the stock moved.

      Allowed values:
      RESTOCKMANUAL_REMOVALSALEREFUND_RETURNCORRECTION
      Example:
      SALE
    • actorNamestringnullable

      Account that made a manual movement. Null for sales and returns.

      Example:
      Hotel Example Shop
    • retailItemIdstring (uuid)nullable

      The retail item a SALE or REFUND_RETURN entry came from.

      Example:
      7d1e2f3a-4b5c-4d6e-8f9a-0b1c2d3e4f5a
    • notestringnullable

      Note recorded with a manual movement.

      Example:
      Delivery from supplier
    • createdAtstring (date-time)

      When the movement was recorded.

      Example:
      2026-07-15T09:12:00Z
Response 200json
{
  "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-Key header.

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
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 401json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}