Read your delivery bands

GET/v1/company/shipping-absorption

scope company.read

Per destination country AND per parcel size: above a threshold you pay the courier, below it the buyer pays at checkout. Bands compare the SELLER-GROUP subtotal — shipping is one charge per seller per order — not a single product's price. Each destination carries TWO independent sets, one per parcel_tier, because the courier prices them very differently: a small RO→HU parcel costs about 26 RON and a large one about 539. The response includes band_rules, which is worth reading before you write.

Response#

Field	Type	Description
`sets`	array	Every band set you have. One per destination PER PARCEL TIER, so the same country normally appears twice — absorbing delivery on an accessory and on a bike are different promises.
`sets[].country_code`	string\|null	The destination, or `null` for the scope's DEFAULT set, used wherever no country-specific set exists.
`sets[].scope`	string	Same country as you is `local`, anywhere else `international`. Accepts `local` · `international`
`sets[].parcel_tier`	string	Which parcel size this set governs. A product's tier is on `GET /v1/products/{id}` as `shipping.parcel_tier`. Accepts `small` · `large`
`sets[].currency`	string\|null	Which currency the band amounts are in.
`sets[].bands`	array	The ladder, in order.
`sets[].bands[].min_amount`	integer	Where the band starts, INCLUSIVE, in minor units.
`sets[].bands[].max_amount`	integer\|null	Where it ends, EXCLUSIVE. `null` on the last band means no upper limit.
`sets[].bands[].absorbs`	boolean	`true` means you pay delivery for orders in this band; `false` means the buyer pays at checkout.
`parcel_tiers`	object	What each tier covers, in words, so you do not have to guess which one a product falls in.
`parcel_tiers.small`	string	What the small tier means.
`parcel_tiers.large`	string	What the large tier means.
`note`	string	How bands are compared — against the seller-group subtotal, not a single product.
`band_rules`	object	The rules a set must satisfy, returned with the data so you can validate before writing rather than by being rejected.
`band_rules.bands_are_half_open`	string	Each band covers `[min, max)` — the maximum is exclusive.
`band_rules.must_be_contiguous`	string	THE RULE THAT CATCHES EVERYONE: a band's `max_amount` must EQUAL the next band's `min_amount`. Writing 49999 then 50000 leaves a one-cent hole and the whole set is refused.
`band_rules.first_band_starts_at_zero`	boolean	The first band must start at `0`.
`band_rules.last_band_is_open_ended`	string	The last band must have `max_amount: null`.
`band_rules.example`	object	A valid set, ready to copy.
`band_rules.example.country_code`	string	Example destination.
`band_rules.example.parcel_tier`	string	Example tier.
`band_rules.example.currency`	string	Example currency.
`band_rules.example.bands`	array	Two contiguous bands: free delivery over 500,00.
`band_rules.example.bands[].min_amount`	integer	Inclusive lower bound.
`band_rules.example.bands[].max_amount`	integer\|null	Exclusive upper bound, `null` on the last.
`band_rules.example.bands[].absorbs`	boolean	Who pays in that band.
`selling_countries`	array	Where you may sell — the only destinations a set may name.
`selling_countries[].country_id`	integer	Our internal id.
`selling_countries[].code`	string	ISO-2, and what `country_code` takes.
`selling_countries[].name`	string	The country name.
`selling_countries[].currency`	string	The currency orders from there settle in.

Example

{
    "sets": [
        {
            "country_code": "HU",
            "scope": "international",
            "parcel_tier": "small",
            "currency": "EUR",
            "bands": [
                {
                    "min_amount": 0,
                    "max_amount": 50000,
                    "absorbs": false
                },
                {
                    "min_amount": 50000,
                    "max_amount": null,
                    "absorbs": true
                }
            ]
        },
        {
            "country_code": "HU",
            "scope": "international",
            "parcel_tier": "large",
            "currency": "EUR",
            "bands": [
                {
                    "min_amount": 0,
                    "max_amount": null,
                    "absorbs": false
                }
            ]
        }
    ],
    "parcel_tiers": {
        "small": "Accessories and small parcels — billed on the small-courier tariff.",
        "large": "Bikes, large and extra-large items — the expensive tariff."
    },
    "note": "Bands compare the seller-group subtotal, in minor units. A band with absorbs=false means the buyer pays delivery at checkout. Each destination has a SEPARATE set per parcel_tier — writing one does not touch the other.",
    "band_rules": {
        "bands_are_half_open": "Each band covers [min_amount, max_amount) — max is exclusive.",
        "must_be_contiguous": "A band's max_amount must equal the next band's min_amount. Not max-1.",
        "first_band_starts_at_zero": true,
        "last_band_is_open_ended": "The last band must have max_amount: null.",
        "example": {
            "country_code": "RO",
            "parcel_tier": "small",
            "currency": "RON",
            "bands": [
                {
                    "min_amount": 0,
                    "max_amount": 50000,
                    "absorbs": false
                },
                {
                    "min_amount": 50000,
                    "max_amount": null,
                    "absorbs": true
                }
            ]
        }
    },
    "selling_countries": [
        {
            "country_id": 70,
            "code": "ES",
            "name": "España",
            "currency": "EUR"
        }
    ]
}

Failures use the shared error envelope — a machine-readable code and a request_id to quote to support. Error handling.