get Basket - Example be.open API

Returns the calculated basket — price, shipping, delivery date and deadline per service provider, plus a total price across all service-provider baskets. The body is validated server-side against a JSON Schema. Response is cached on the CDN for 1 hour (3600s) — re-querying right after a configuration change can therefore still return the previous price until the cache expires.

Request

Body Params application/json

Example

{
    "delivery_address": {
        "first_name": "Max",
        "last_name": "Mustermann",
        "street": "Beispielstraße",
        "house_number": "12a",
        "zip_code": "10115",
        "city": "Berlin",
        "country": "DE"
    },
    "currency": "EUR",
    "products": [
        {
            "sku": "06dc8c77-097e-4ed6-b225-d468e3c0f3f2",
            "copies": 100,
            "pages": 0,
            "color_pages": 0,
            "independent_options": []
        }
    ]
}

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "jsonapi": {
        "version": "1.0"
    },
    "data": {
        "type": "basket",
        "id": "b1b2b3b4-0000-0000-0000-000000000001",
        "attributes": {
            "baskets": [
                {
                    "serviceprovider": "Service Provider DE",
                    "products": [
                        {
                            "price": {
                                "net": 12.5,
                                "gross": 14.88,
                                "vat": 2.38,
                                "currency": "EUR"
                            },
                            "delivery_date": "2026-06-02",
                            "deadline": "2026-05-30T14:00:00+02:00",
                            "spine_width": 0
                        }
                    ],
                    "price": {
                        "net": 12.5,
                        "gross": 14.88,
                        "vat": 2.38,
                        "currency": "EUR"
                    }
                }
            ],
            "delivery_address": {
                "type": "addresses",
                "id": "addr-1",
                "attributes": {
                    "first_name": "Max",
                    "last_name": "Mustermann",
                    "street": "Beispielstraße",
                    "house_number": "12a",
                    "zip_code": "10115",
                    "city": "Berlin",
                    "country": "DE",
                    "salutation": null,
                    "company": null,
                    "additional_line": null,
                    "email": null,
                    "phone": null,
                    "comment": null,
                    "vat_number": null
                }
            },
            "price": {
                "net": 12.5,
                "gross": 14.88,
                "vat": 2.38,
                "currency": "EUR"
            }
        }
    }
}