Public tools API

Parameters

• piecesrequiredqty x length x width x height x weightPerPiece, “;”-separated. cm/kg (metric) or in/lb (imperial). e.g. 2x120x80x100x50;1x60x40x30x12
• unitoptionalmetric (default) | imperial
• stackableoptionaltrue (default) | false — affects LDM
• airDivisoroptionalair volumetric divisor, cm³/kg (default 6000)
• expressDivisoroptionalcourier DIM divisor (default 5000)
• seaEquivalenceoptionalsea W/M kg per m³ (default 1000)
• seaMinRevenueTonsoptionalLCL minimum W/M (default 1)
• roadDensityoptionalroad volumetric density kg/m³ (default 333)
• roadUseLdmoptionaltrue | false (default) — enable LDM basis
• roadKgPerLdmoptionalkg per loading metre (default 1750)

Example

curl "https://glauc.cat/api/tools/chargeable-weight?pieces=2x120x80x100x50&unit=metric"

Response (excerpt)

{ "ok": true, "data": { "result": { "totals": { "grossKg": 100, "volumeM3": 1.92 }, "results": [ { "mode": "air", "chargeableKg": 320, "chargeableRoundedKg": 320, "basis": "volume" }, … ] } } }

Parameters

• deliveryrequireddelivery date, YYYY-MM-DD
• caseoptionaldamage (default) | totalLoss | other — Art. 32 start rule
• wilfuloptionaltrue → 3-year limitation (default false)
• excludedWeekdaysoptionalcomma list, 0=Sun … 6=Sat (default 0)
• holidaysoptionalcomma list of YYYY-MM-DD public holidays
• holidayCountryoptionalES | PT | FR | DE | IT | BE | NL | PL — auto-adds national holidays of the delivery year and the next one
• agreedTimeLimitExpiryoptionaltotalLoss: agreed time-limit expiry
• takingOverDateoptionaltotalLoss without agreed limit: taking-over date
• contractDateoptionalother cases: contract conclusion date

Example

curl "https://glauc.cat/api/tools/cmr-deadlines?delivery=2026-07-01"

Response (excerpt)

{ "ok": true, "data": { "result": { "apparent": { "deadline": "2026-07-01" }, "nonApparent": { "deadline": "2026-07-09" }, "delay": { "deadline": "2026-07-22" }, "limitation": { "deadline": "2027-07-01" } } } }

Parameters

• categoryrequiredlength | weight | volume | density | area | temperature | speed | fuel | floor | containers
• valuerequirednumeric value to convert
• fromrequiredsource unit id (e.g. cm, kg, m3, kgm3)
• tooptionaltarget unit id; omitted → all units in the category

Example

curl "https://glauc.cat/api/tools/unit-converter?category=volume&value=1&from=m3&to=ft3"

Response (excerpt)

{ "ok": true, "data": { "result": 35.3146667… } }

Parameters

• codeoptionalEXW … DDP; omitted → all 11 rules

Example

curl "https://glauc.cat/api/tools/incoterms?code=FOB"

Response (excerpt)

{ "ok": true, "data": { "code": "FOB", "group": "F", "mode": "sea", "costs": { "mainCarriage": "buyer", … }, "riskTransfer": "fob" } }

Parameters

• sinceBreakoptionalminutes driven since the last ≥45-min break
• todayoptionalminutes driven today
• weekoptionalminutes driven this week
• previousWeekoptionalminutes driven the previous week
• extensionsUsedoptional10 h days used this week (0–2)
• reducedRestsUsedoptionalreduced rests used (0–3)

Example

curl "https://glauc.cat/api/tools/driving-hours?sinceBreak=240&today=420&week=2600"

Response (excerpt)

{ "ok": true, "data": { "assessment": { "untilBreak": 30, "todayRemaining": 120, "todayRemainingExtended": 180, "weekRemaining": 760, "effectiveRemaining": 180, … } } }

Parameters

• massrequiredcargo mass, kg
• murequiredfriction coefficient, 0–1 (EN 12195-1 Annex B)
• alphaoptionalvertical lashing angle, degrees (default 85)
• methodoptionaltie-down (default) or direct
• modeoptionalroad (default, Table 2) | rail (Table 3) | seaA | seaB | seaC (Table 4 sea areas)
• stfoptionalSTF per lashing, daN (tie-down; default 400)
• lcoptionalLC per lashing, daN (direct; default 2500)
• betaoptionalhorizontal lashing angle, degrees (direct; default 30)
• lengthoptionalblock length, cm (tipping check)
• widthoptionalblock width, cm
• heightoptionalblock height, cm
• cogHeightoptionalcentre of gravity height, cm (default half the height)

Example

curl "https://glauc.cat/api/tools/cargo-securing?mass=6000&mu=0.45&alpha=85&stf=400&length=240&width=120&height=180"

Response (excerpt)

{ "ok": true, "data": { "result": { "method": "tie-down", "lashings": 4, "directions": [ { "direction": "forward", "sliding": 4, "tipping": 0, "required": 4 }, … ], "warnings": [ … ] } } }

Parameters

• qoptionalcode prefix (digits) or words, at least two characters (q or code is needed)
• codeoptionalexact 4-, 6- or 8-digit code instead of q
• langoptionalen (default) or es
• limitoptionalmax rows, 1–100 (default 25)

Example

curl "https://glauc.cat/api/tools/hs-codes?q=lithium%20batteries&lang=en"

Response (excerpt)

{ "ok": true, "data": { "total": 6, "rows": [ { "code": "85076000", "level": 8, "description": "Lithium-ion accumulators", "heading": "Electric accumulators…", "duty": "2,7 %", "unit": "p/st" }, … ], "source": { … } } }

Parameters

• equipmentrequired20DV | 40DV | 40HC | 45HC | 20RF | 40RFHC | TAUT | MEGA | FRIGO
• piecesrequiredqty x length x width x height x weightPerPiece (cm/kg), separated by ";" — at most 600 units per request
• stackableoptionaldefault true — pieces may be stacked
• thisSideUpoptionaldefault true — pieces must not be tipped
• countryoptionalroad limit matrix: ES (default) | EU | US | CN
• modeoptionalroad_national (default) | road_international | road_intermodal

Example

curl "https://glauc.cat/api/tools/load-planner?equipment=40HC&pieces=20x120x80x144x400"

Response (excerpt)

{ "ok": true, "data": { "metrics": { "packedCount": 20, "volumeUtilizationPct": 36.4, "vgmKg": 11700, "cog": { "xEccentricityPct": -0.8, "ok": true }, … }, "compliance": { … }, "placements": [ … ] } }

Liveness probe: one real calculation per engine, plus the review date and source of every tool (and the loaded CN dataset). Never rate-limited, never counted.

Example

curl "https://glauc.cat/api/tools/health"

Response (excerpt)

{ "ok": true, "version": "1", "checks": { "chargeable-weight": true, … }, "review": { "hs-codes": { "verifiedOn": "2026-09-06", "dataset": "CN 2026, Reg. (EU) 2025/1926", "datasetYear": 2026 }, … } }