Storefront API · Cart

Create a cart

POSThttps://{store}/api/v1/carts

Creates an empty cart in the store’s currency and returns its token in meta.cart_token. Keep the token (for example in the app’s storage) and send it as X-Cart-Token with every other call.

No authorization.

Responses

201The new cart and its token.

{
    "data": {
        "id": "42",
        "currency": "UAH",
        "lines": [],
        "totals": {
            "subtotal": 0,
            "shipping": 0,
            "tax": 0,
            "discount": 0,
            "total": 0
        },
        "shipping_option": null,
        "shipping_paid_by": null,
        "shipping_delivery": null
    },
    "meta": {
        "cart_token": "9f3c2a7e5b1d4c8a…"
    }
}

429Too many requests (cart creation 20/min per IP, cart calls 120/min, checkout 10/min).

{
    "message": "Too Many Attempts."
}

{ "data": { "id": "42", "currency": "UAH", "lines": [], "totals": { "subtotal": 0, "shipping": 0, "tax": 0, "discount": 0, "total": 0 }, "shipping_option": null, "shipping_paid_by": null, "shipping_delivery": null }, "meta": { "cart_token": "9f3c2a7e5b1d4c8a…" } }