Getting startedAPI referenceHow-tosChangelog
Search…
How-tos
Introduction
Product listing page
Product page
Shopping cart
Creating a shopping cart
Adding products to cart
Updating cart quantities
Removing products from cart
Displaying the cart summary
Checkout
Payments
Inventory strategies
Displaying the cart summary
How to show an order summary to your customers

Problem

You want to display an order summary to your customer, including the order line items and totals.
A sample cart summary

Solution

To retrieve the list of line items that compose an order summary, send a GET request to the /api/orders/:id endpoint and include its line items.
To get a faster response and fewer data to parse, we recommend requesting only the fields you need to show in the cart summary.

Example

Request
Response
The following request fetches the list of line items associated with the order identified by the "yzkWXfgHQS" ID, with a specific selection of the fields you need to show in the cart summary:
1
curl -g -X GET \
2
'https://yourdomain.commercelayer.io/api/orders/yzkWXfgHQS?include=line_items&fields[orders]=number,skus_count,formatted_subtotal_amount,formatted_discount_amount,formatted_shipping_amount,formatted_total_tax_amount,formatted_gift_card_amount,formatted_total_amount_with_taxes,line_items&fields[line_items]=item_type,image_url,name,sku_code,formatted_unit_amount,quantity,formatted_total_amount' \
3
-H 'Accept: application/vnd.api+json' \
4
-H 'Authorization: Bearer your-access-token'
Copied!
On success, the API responds with a 200 OK status code, returning the order object with all the line items included, showing only the requested fieldset:
1
{
2
"data": {
3
"id": "yzkWXfgHQS",
4
"type": "orders",
5
"links": {
6
"self": "https://yourdomain.commercelayer.io/api/orders/yzkWXfgHQS"
7
},
8
"attributes": {
9
"number": 1234,
10
"skus_count": 7,
11
"formatted_subtotal_amount": "843.00€",
12
"formatted_discount_amount": "-84.30€",
13
"formatted_shipping_amount": "10.00€",
14
"formatted_total_tax_amount": "168.60€",
15
"formatted_gift_card_amount": "-50.00€",
16
"formatted_total_amount_with_taxes": "718.70€"
17
},
18
"relationships": {
19
"line_items": {
20
"links": {...},
21
"data": [
22
{
23
"type": "line_items",
24
"id": "aBmNkPQRst"
25
},
26
{
27
"type": "line_items",
28
"id": "kXBqtVaYMN"
29
},
30
{
31
"type": "line_items",
32
"id": "ypQptRQABk"
33
},
34
{
35
"type": "line_items",
36
"id": "yaoMtJoqjv"
37
},
38
{
39
"other": "... line items"
40
}
41
]
42
}
43
},
44
"meta": {
45
"mode": "test"
46
}
47
},
48
"included": [
49
{
50
"id": "aBmNkPQRst",
51
"type": "line_items",
52
"links": {
53
"self": "https://spineless.commercelayer.io/api/line_items/aBmNkPQRst"
54
},
55
"attributes": {
56
"item_type": "skus",
57
"image_url": "https://img.yourdomain.com/skus/TSHIRTB5B5B5XL.png",
58
"name": "Grey T-Shirt XL",
59
"sku_code": "TSHIRTB5B5B5XL",
60
"formatted_unit_amount": "129.00€",
61
"quantity": 2,
62
"formatted_total_amount": "258.00€"
63
},
64
"meta": {
65
"mode": "test"
66
}
67
},
68
{
69
"id": "kXBqtVaYMN",
70
"type": "line_items",
71
"links": {
72
"self": "https://spineless.commercelayer.io/api/line_items/kXBqtVaYMN"
73
},
74
"attributes": {
75
"item_type": "skus",
76
"image_url": "https://img.yourdomain.com/skus/SHOESFFFFFF41.png",
77
"name": "White Shoes 41",
78
"sku_code": "SHOESFFFFFF41",
79
"formatted_unit_amount": "299.00€",
80
"quantity": 1,
81
"formatted_total_amount": "299.00€"
82
},
83
"meta": {
84
"mode": "test"
85
}
86
},
87
{
88
"id": "ypQptRQABk",
89
"type": "line_items",
90
"links": {
91
"self": "https://spineless.commercelayer.io/api/line_items/ypQptRQABk"
92
},
93
"attributes": {
94
"item_type": "skus",
95
"image_url": "https://img.yourdomain.com/skus/HOODIE000000M.png",
96
"name": "Black Hoodie M",
97
"sku_code": "HOODIE000000M",
98
"formatted_unit_amount": "199.00€",
99
"quantity": 1,
100
"formatted_total_amount": "199.00€"
101
},
102
"meta": {
103
"mode": "test"
104
}
105
},
106
{
107
"id": "yaoMtJoqjv",
108
"type": "line_items",
109
"links": {
110
"self": "https://spineless.commercelayer.io/api/line_items/yaoMtJoqjv"
111
},
112
"attributes": {
113
"item_type": "skus",
114
"image_url": "https://img.yourdomain.com/skus/SOCKS212F3FXS.png",
115
"name": "Blue Socks XS",
116
"sku_code": "SOCKS212F3FXS",
117
"formatted_unit_amount": "29.00€",
118
"quantity": 3,
119
"formatted_total_amount": "87.00€"
120
},
121
"meta": {
122
"mode": "test"
123
}
124
},
125
{
126
"other": "... line items (different item types)"
127
}
128
]
129
}
Copied!

Mapping

The image below shows how each of the elements of the shopping cart is mapped to a specific field of the order or line item objects.
A sample cart summary mapping

Additional notes

Filtering by item type

You may have noticed the pseudo-code { "other": "... line items (different item types)" } in the response. That's because the above request fetches all the line items associated with the order (SKUs, shipments, payment methods, and promotions). If you plan to use only some of them, remember to properly filter them through some client-side logic based on their item_type attribute.

Showing the payment method cost

Commerce Layer supports the option for payment methods to have a cost. If that's your case and you want to display it in the cart summary, remember to add also the formatted_payment_method_amount order's field in the API call above.

More to read

See our documentation if you need more information on how to retrieve an order. For further details on how to use include and fields queries in your request, see including associations and sparse fieldset.
Previous
Removing products from cart
Next
Checkout
Last modified 3mo ago
Copy link
Contents
Problem
Solution
Example
Mapping
Additional notes
More to read