Skip to content
Ratelio

Team plan

API

Price shipments from your own rate tables and create draft quotes from your systems. JSON over HTTPS; one key per person and company.

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.
  • 402 quote_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.