{"openapi":"3.1.0","info":{"title":"Mobile Crane Lift API","version":"1.0.0","description":"Mobile-crane lift-planning maths as an API, computed locally and deterministically — the load-moment, tipping-capacity and outrigger-pad numbers a crane operator, lift planner or rigging engineer checks a pick with. The load-moment endpoint gives the load × its working radius (the horizontal distance from the slew centre to the hook), the single figure a crane's rated-capacity limiter watches: a 5-tonne load at 8 m is a 40 tonne-metre moment, the same as 10 tonnes at 4 m, which is why chart capacity falls steeply as the boom luffs out — moment, not weight, tips the crane. The capacity endpoint gives a simplified tipping balance about the fulcrum: the load that just tips = counterweight × its radius ÷ the load radius, and the rated safe load is a stability fraction of that (~75 % on outriggers, ~66 % on crawlers per the standards) — a teaching/sanity figure that ignores the boom and superstructure, never a substitute for the load chart. The outrigger-pad endpoint sizes the float: required pad area = the outrigger leg load ÷ the soil's allowable bearing pressure (and the side of a square mat), since overloading weak ground is a leading cause of overturns — a 30-tonne leg on 200 kPa wants about a 1.2 m square mat. Everything is computed locally and deterministically, so it is instant and private. Ideal for lift-planning and rigging tools, construction and crane-operations apps, and site-safety utilities. Pure local computation — no key, no third-party service, instant. Simplified — always use the manufacturer load chart. 3 compute endpoints. For sling and WLL loads use a rigging API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/crane-api","description":"oanor gateway"}],"tags":[{"name":"Crane"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/capacity":{"get":{"operationId":"get_v1_capacity","tags":["Crane"],"summary":"Tipping-limited safe load","description":"","parameters":[{"name":"counterweight_tonnes","in":"query","required":true,"description":"Counterweight (tonnes)","schema":{"type":"string"},"example":"20"},{"name":"counterweight_radius_m","in":"query","required":true,"description":"Counterweight radius (m)","schema":{"type":"string"},"example":"3"},{"name":"load_radius_m","in":"query","required":true,"description":"Load radius (m)","schema":{"type":"string"},"example":"8"},{"name":"stability_factor","in":"query","required":false,"description":"Stability factor (default 0.75)","schema":{"type":"string"},"example":"0.75"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"A simplified tipping balance about the fulcrum (the tipping line): the load that just tips the crane = counterweight × its radius ÷ the load radius, and the rated safe load is a stability fraction of that — about 75 % for mobile cranes on outriggers, 66 % on crawlers/tyres per the standards. This ignores the boom and superstructure weight (the real chart accounts for them), so treat it as a teaching/sanity figure, never a substitute for the load chart.","inputs":{"load_radius_m":8,"stability_factor":0.75,"counterweight_tonnes":20,"counterweight_radius_m":3},"safe_load_tonnes":5.63,"tipping_load_tonnes":7.5},"meta":{"timestamp":"2026-06-07T08:17:57.342Z","request_id":"05a0ef3e-f0b8-4de3-87bd-2cbb501d9d9e"},"status":"ok","message":"Capacity","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/load-moment":{"get":{"operationId":"get_v1_load_moment","tags":["Crane"],"summary":"Load moment from load and radius","description":"","parameters":[{"name":"load_tonnes","in":"query","required":true,"description":"Load (tonnes)","schema":{"type":"string"},"example":"5"},{"name":"radius_m","in":"query","required":true,"description":"Working radius (m)","schema":{"type":"string"},"example":"8"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The load moment = the load × its working radius (the horizontal distance from the slew centre to the hook), the single number a crane's rated-capacity limiter watches. A 5-tonne load at 8 m is a 40 tonne-metre moment; the same 40 t·m is reached by 10 tonnes at 4 m. That is why a crane's chart capacity falls steeply as the boom is luffed out — moment, not weight, is what tips it.","inputs":{"radius_m":8,"load_tonnes":5},"load_moment_kn_m":392.3,"load_moment_tonne_m":40},"meta":{"timestamp":"2026-06-07T08:17:57.430Z","request_id":"60151e37-c32e-470d-9058-9c34a7071cae"},"status":"ok","message":"Load moment","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/outrigger-pad":{"get":{"operationId":"get_v1_outrigger_pad","tags":["Crane"],"summary":"Outrigger pad area from bearing","description":"","parameters":[{"name":"outrigger_load_tonnes","in":"query","required":true,"description":"Outrigger leg load (tonnes)","schema":{"type":"string"},"example":"30"},{"name":"allowable_bearing_kpa","in":"query","required":true,"description":"Allowable ground bearing (kPa)","schema":{"type":"string"},"example":"200"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The outrigger float spreads the leg load over the ground: required pad area = the outrigger load ÷ the soil's allowable bearing pressure, and a square pad needs that area's square root per side. A 30-tonne leg load on 200 kPa ground wants about 1.5 m² — roughly a 1.2 m square mat. Weak or made ground needs far bigger mats or cribbing; overloading the soil is a leading cause of crane overturns.","inputs":{"allowable_bearing_kpa":200,"outrigger_load_tonnes":30},"square_pad_side_m":1.213,"ground_pressure_kpa":200,"required_pad_area_m2":1.471},"meta":{"timestamp":"2026-06-07T08:17:57.532Z","request_id":"3e450c19-33c0-438c-b089-73d139e6f9b7"},"status":"ok","message":"Outrigger pad","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"notes":"Metric (t, m, kN·m, kPa, m²). moment = load·radius; tipping load = CW·CW-radius/load-radius, safe = ×stability (~0.75 outriggers); pad area = load·g ÷ bearing. Simplified — always use the manufacturer load chart. For sling/WLL loads use a rigging API.","service":"crane-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/capacity":"Tipping-limited safe load from the counterweight balance.","GET /v1/load-moment":"Load moment from load and working radius.","GET /v1/outrigger-pad":"Outrigger pad area from the ground-bearing pressure."},"description":"Mobile-crane lift maths: load moment, tipping-limited safe capacity, and outrigger pad size."},"meta":{"timestamp":"2026-06-07T08:17:57.607Z","request_id":"68f4ee05-6706-473f-a750-7880a1da2611"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":4550,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1340,"monthly_call_quota":47500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4180,"monthly_call_quota":203000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":12750,"monthly_call_quota":1095000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/crane-api"}