Get cart items

Description

This service retrieves all items currently in the cart for a given mileage activity.

---

Request

Restrictions

This service requires an authenticated user and can only be called after a successful consumer login.

Endpoint

GET https://<server-url>/api/v4/mileage/{activity_code}/cart/items

Path Parameters

Parameter	Type	Description
activity_code	String	The unique code for the mileage activity whose cart will be retrieved.

Parameters

Parameter	Location	Description
touchpoint	Query / Header	The identifier for the touchpoint. Use Thalamus-Touchpoint for the header.
token	Query / Header	The authentication token for the API session. Use Thalamus-Token for the header.

Full URL Example

https://<server-url>/api/v4/mileage/MPOINTS/cart/items?touchpoint=test&token=...

Request Body

This request does not have a body.

---

Response

✅ Successful Response: 200 OK

A JSON object is returned containing an array of all items in the cart. Each object in the items array represents a line item with the following structure:

Field	Type	Description
item	Object	An object containing the full details of the catalog item.
quantity	Integer	The number of units of this item in the cart.
total	Number	The total point cost for this line item (item price × quantity).

JSON

{
  "items": [
    {
      "item": {
        "code": "001",
        "name": "Glass",
        "shortDescription": "Glass glass",
        "longDescription": "Glass glass glass",
        "tags": "glass,kitchen,food",
        "smallImageURL": "http://image.com/small-glass.jpg",
        "mediumImageURL": "http://image.com/medium-glass.jpg",
        "largeImageURL": "http://image.com/large-glass.jpg",
        "description1": "descrp1",
        "description2": "descrp2",
        "description3": "descrp3",
        "description4": "descrp4",
        "description5": "descrp5",
        "itemType": "Physical Item",
        "price": 10,
        "available": true,
        "chance": false
      },
      "quantity": 8,
      "total": 80
    }
  ]
}

❌ Unsuccessful Response: 404 Not Found

Returned if the specified activity_code does not exist.

JSON

{
  "errors": {
    "error.message": "NOT_FOUND"
  }
}