---
title: "Get order details"
method: GET
path: "/order/{uuid}/details"
tags: ["Orders"]
---

# Get order details

`GET /order/{uuid}/details`

## Request

- Base URL: `https://integrations-sandbox.shopback.com/demo/merchant`
- URL: `https://integrations-sandbox.shopback.com/demo/merchant/order/{uuid}/details`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/shopback/apis/online-payments-api/docs/order/:uuid/details/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `uuid` string, required

## Headers

- `Authorization` string, required
- `X-ShopBack-Idempotent-Id` string

## Response `200`

successful operation

- DetailedMerchantOrderResponse
  - `id` integer, required: Order ID
  - `uuid` string, required: Randomly generated order uuid
  - `createdAt` string, date-time, required: Order creation time
  - `status` 'INITIATED' | 'APPROVED' | 'CANCELLED' | 'REJECTED' | 'REFUNDED', required: Order status provided to the merchant
  - `orderType` 'INSTORE' | 'ONLINE', required: Order type
  - `initialAmount` number, required: Initial total amount of order
  - `totalAmount` number, required: Total amount of order, includes all items
  - `originalAmount` number, required: Pre discount amount of order, includes all items
  - `taxAmount` number: Total tax for the order
  - `voucherCode` string: Any voucher code to be applied on order
  - `currency` string, required: Currency of the order
  - `merchantRef` string, required
  - `consumerEmail` string, required: Consumer's email
  - `shippingAddress` AddressResponse, required
    - `id` integer: Internal database id
    - `uuid` string: Randomly generated Address uuid
    - `createdAt` string, date-time: Order creation time
    - `line1` string: line1 of address
    - `line2` string: line2 of address
    - `line3` string: line3 of address
    - `suburb` string: suburb
    - `postcode` string: postcode
    - `countryCode` string: countryCode
    - `district` string: district
    - `generalDistrictLocation` string: generalDistrictLocation
    - `city` string: city
    - `state` string: state
  - `shippingMethod` 'NORMAL' | 'EXPRESS' | 'PICKUP' | 'FREE' | 'MERCHANT_SPECIFIED': Shipping method preferred for order
  - `orderItems` MerchantOrderItemResponse[], required: List of order items
    - `name` string, required: The name of the item
    - `sku` string: Store keeping unit at the merchant level
    - `ean` string: The items EAN
    - `description` string: Short description of the item
    - `detailedDescription` string: Detailed description of the item
    - `quantity` integer, required: Quantity of the item
    - `amount` number: Actual price of the item
    - `originalAmount` number: Pre discount amount of the item
    - `taxAmount` number: Tax amount of the item
    - `images` OrderItemImageResponse[]: List of order item images
      - `imageLocation` string, required
  - `shippingAmount` number: shipping amount
  - `paymentType` 'PAYLATER' | 'PAY': Customer’s payment type. Populated for approved and refunded orders only. Returned only for enabled outlets.
  - `failureReason` string, nullable: Failure reason for rejected orders. Returned only for enabled outlets.
  - `ccdOrderReference` string: ShopBack's order reference in format YYMMDD-NNNN-AAAA. Returned only for enabled outlets.

## Other responses

- `404`: Not Found, Merchant not found/Currency not found
- `412`: Precondition Failed, Provided token is invalid or expired
- `500`: Internal Server Error, Something went wrong on servers's end.

## Changes

- **2026-11-03** `a3ac503a275e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shopback/apis/online-payments-api/changes/order/:uuid/details/get.md)

---

[API](https://skmtc.dev/shopback/apis/online-payments-api.md) - [All operations](https://skmtc.dev/shopback/apis/online-payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shopback/apis/online-payments-api/revisions/a3ac503a275e?raw)