---
title: "Retrieves a CustomerOrder resource."
method: GET
path: "/customer-orders/{id}"
tags: ["Customer Order"]
---

# Retrieves a CustomerOrder resource.

`GET /customer-orders/{id}`

## Request

- Base URL: `http://localhost:8000/api/shop`
- URL: `http://localhost:8000/api/shop/customer-orders/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-shop-api/docs/customer-orders/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves a CustomerOrder resource.

## Path parameters

- `id` string, required

## Headers

- `X-STOREFRONT-KEY` string, required
- `X-Locale` string
- `X-Channel` string
- `X-Currency` string

## Response `200`

CustomerOrder resource

- CustomerOrderCustomerOrderDetailDto: Customer Order API Resource Standalone model pointing to the `orders` table with explicit field casts and hand-picked relationships. Follows the same pattern as CustomerInvoice to avoid inheriting unwanted relationships from the base Order model (morphTo fields, proxy relationships) that can break API Platform serialization. This is a read-only, customer-scoped resource.
  - `id` integer, nullable
  - `incrementId` string, nullable
  - `status` string, nullable
  - `channelName` string, nullable
  - `isGuest` boolean, nullable
  - `customerEmail` string, nullable
  - `customerFirstName` string, nullable
  - `customerLastName` string, nullable
  - `customerFullName` string, nullable
  - `shippingMethod` string, nullable
  - `shippingTitle` string, nullable
  - `shippingDescription` string, nullable
  - `couponCode` string, nullable
  - `isGift` boolean, nullable
  - `totalItemCount` integer, nullable
  - `totalQtyOrdered` integer, nullable
  - `baseCurrencyCode` string, nullable
  - `channelCurrencyCode` string, nullable
  - `orderCurrencyCode` string, nullable
  - `grandTotal` number, nullable
  - `baseGrandTotal` number, nullable
  - `grandTotalInvoiced` number, nullable
  - `baseGrandTotalInvoiced` number, nullable
  - `grandTotalRefunded` number, nullable
  - `baseGrandTotalRefunded` number, nullable
  - `subTotal` number, nullable
  - `baseSubTotal` number, nullable
  - `subTotalInvoiced` number, nullable
  - `baseSubTotalInvoiced` number, nullable
  - `subTotalRefunded` number, nullable
  - `baseSubTotalRefunded` number, nullable
  - `discountPercent` number, nullable
  - `discountAmount` number, nullable
  - `baseDiscountAmount` number, nullable
  - `discountInvoiced` number, nullable
  - `baseDiscountInvoiced` number, nullable
  - `discountRefunded` number, nullable
  - `baseDiscountRefunded` number, nullable
  - `taxAmount` number, nullable
  - `baseTaxAmount` number, nullable
  - `taxAmountInvoiced` number, nullable
  - `baseTaxAmountInvoiced` number, nullable
  - `taxAmountRefunded` number, nullable
  - `baseTaxAmountRefunded` number, nullable
  - `shippingAmount` number, nullable
  - `baseShippingAmount` number, nullable
  - `shippingInvoiced` number, nullable
  - `baseShippingInvoiced` number, nullable
  - `shippingRefunded` number, nullable
  - `baseShippingRefunded` number, nullable
  - `shippingDiscountAmount` number, nullable
  - `baseShippingDiscountAmount` number, nullable
  - `shippingTaxAmount` number, nullable
  - `baseShippingTaxAmount` number, nullable
  - `shippingTaxRefunded` number, nullable
  - `baseShippingTaxRefunded` number, nullable
  - `subTotalInclTax` number, nullable
  - `baseSubTotalInclTax` number, nullable
  - `shippingAmountInclTax` number, nullable
  - `baseShippingAmountInclTax` number, nullable
  - `customerId` integer, nullable
  - `channelId` integer, nullable
  - `cartId` integer, nullable
  - `appliedCartRuleIds` string, nullable
  - `createdAt` string, nullable
  - `updatedAt` string, nullable
  - `items` OrderItemDto[]
    - `id` integer, nullable
    - `sku` string, nullable
    - `type` string, nullable
    - `name` string, nullable
    - `productId` integer, nullable
    - `productType` string, nullable
    - `qtyOrdered` integer, nullable
    - `qtyShipped` integer, nullable
    - `qtyInvoiced` integer, nullable
    - `qtyCanceled` integer, nullable
    - `qtyRefunded` integer, nullable
    - `price` number, nullable
    - `basePrice` number, nullable
    - `total` number, nullable
    - `baseTotal` number, nullable
    - `discountPercent` number, nullable
    - `discountAmount` number, nullable
    - `taxPercent` number, nullable
    - `taxAmount` number, nullable
    - `priceInclTax` number, nullable
    - `totalInclTax` number, nullable
  - `addresses` OrderAddressDto[]
    - `id` integer, nullable
    - `addressType` string, nullable
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `gender` string, nullable
    - `companyName` string, nullable
    - `address` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `country` string, nullable
    - `postcode` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `vatId` string, nullable
  - `payment` OrderPaymentDto
    - `id` integer, nullable
    - `method` string, nullable
    - `methodTitle` string, nullable
  - `shipments` OrderShipmentDto[]
    - `id` integer, nullable
    - `shippingNumber` string, nullable
    - `carrierTitle` string, nullable
    - `carrierCode` string, nullable
    - `trackNumber` string, nullable
    - `totalQty` integer, nullable
    - `totalWeight` number, nullable
    - `emailSent` boolean, nullable
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
    - `items` OrderShipmentItemDto[]
      - `id` integer, nullable
      - `orderItemId` integer, nullable
      - `qty` integer, nullable
      - `weight` number, nullable
  - `hasNonCancelableBooking` unknown

## Other responses

- `404`: Not found

## Changes

- **2026-10-28** `b84d43839844`: 2 info
  - added the optional property `hasNonCancelableBooking` to the response with the `200` status (media type: application/json)
  - added the optional property `hasNonCancelableBooking` to the response with the `200` status (media type: text/html)

[Operation history](https://skmtc.dev/bagisto/apis/bagisto-shop-api/changes/customer-orders/:id/get.md)

---

[API](https://skmtc.dev/bagisto/apis/bagisto-shop-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-shop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-shop-api/revisions/f619df36bf29?raw)