List the signed-in member's carts

GET

/carts

const url = 'https://acme.mykreezalid.com/front_api/v1/carts';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://acme.mykreezalid.com/front_api/v1/carts \
  --header 'Authorization: Bearer <token>'

Returns every cart the signed-in member owns, whatever its state (closed carts included), without its content. To get a cart’s orders, items and amounts, call GET /carts/{url_key}. The list is not paginated. Each record can carry more fields than the ones below: rely only on these.

Authorizations

bearerAuth

Responses

200

The member’s carts.

application/json

object

carts

Array<object>

object

object

string

integer

url_key

string

cart_status

State of the cart, such as open, checkout_in_progress or closed.

string

customer_id

integer

tmp_customer_id

Set when the cart was started as a guest cart.

integer

nullable

order_count

integer

order_item_count

integer

currency

string

created

string format: date-time

modified

string format: date-time

Example

{
  "carts": [
    {
      "object": "Cart",
      "id": 4242,
      "url_key": "k3v9q2m8x1c7z5b4n6t0p2r8s1d3f7",
      "cart_status": "open",
      "customer_id": 4242,
      "tmp_customer_id": 98765,
      "order_count": 1,
      "order_item_count": 2,
      "currency": "EUR"
    }
  ]
}

403

No token, or the token is not valid.

application/json

Error body returned by the Front API when it refuses a request.

object

code

HTTP status code, repeated in the body.

integer

status

string

message

Human-readable reason.

string

Example

{
  "code": 403,
  "status": "error",
  "message": "Token not found in request"
}