Authentication
Create a key in Settings → API keys (owners and admins, Team plan). Send it as a Bearer token. A key stops working when its owner leaves the company.
Authorization: Bearer 12|xxxxxxxxxxxxxxxxxxxxxxxx
Accept: application/json
Price a shipment
POST https://ratelio.talivio.com/api/v1/price — nothing is stored.
{ "origin_country": "EE", "dest_country": "LV", "dest_postcode": "1010", "pallets": 3 }
Fields: dest_country (ISO code, required), dest_postcode, origin_country, pallets, weight_kg, volume_cbm, ldm. Pallet tables need pallets; weight tables use the largest of kg, m³ × kg/m³ and ldm × kg/ldm.
{ "ok": true, "zone": "LV Riga", "unit": "pallet", "chargeable": 3, "base": 279, "fuel": 51.62,
"fuel_pct": 18.5, "margin": 39.67, "margin_pct": 12, "total": 370.29, "currency": "EUR", "rate_table": "…" }
Amounts are net, VAT excluded. margin is for your systems only — do not show it to the shipper.
Create a draft quote
POST https://ratelio.talivio.com/api/v1/quotes with the same fields plus optional customer_company, customer_name, customer_email, goods. Returns 201 with the quote number. The quote is a draft: a person sends it from the panel. GET https://ratelio.talivio.com/api/v1/quotes/{number} reads it back, including its status (draft, sent, won, lost, expired).
Errors
401— missing or revoked key.402quote_quota_exceeded— trial limit reached or the subscription has lapsed.403— the company is not on the Team plan.422— validation error, or the tariff does not cover the shipment (error:country_not_covered,postcode_not_covered,missing_pallets,missing_weight,above_tariff,no_active_table).429— more than 120 requests per minute.