{"openapi":"3.1.0","info":{"title":"Belt Conveyor API","version":"1.0.0","description":"Belt-conveyor design maths as an API, computed locally and deterministically. The capacity endpoint computes the throughput of a belt conveyor — the volumetric capacity Q = A·v·3600 (m³/h) from the belt cross-section and speed, and the mass capacity Q·ρ/1000 (t/h) from the bulk density — and, when only the belt width is given, estimates the cross-section as A ≈ load_factor·width². The power endpoint computes the drive power as the sum of the horizontal friction power, μ·g·(material + 2·belt + idler mass per metre)·length·speed, and the vertical lift power, ṁ·g·height, then divides by the drive efficiency to give the motor power. The tension endpoint computes the belt tensions from the effective tension Te = P/v: the tight-side tension T1 = Te·e^(μθ)/(e^(μθ)−1) and the slack-side tension T2 = T1 − Te, using the Euler-Eytelwein grip of the belt on the drive pulley. Everything is computed locally and deterministically, so it is instant and private. Ideal for bulk-materials-handling, mining and plant-design tools, conveyor selection and motor sizing, and mechanical-engineering education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is a simplified belt-conveyor model; for rope/belt capstan friction use a capstan API and for belt-drive geometry use a belt-drive API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/conveyor-api","description":"oanor gateway"}],"tags":[{"name":"Conveyor"},{"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":["Conveyor"],"summary":"Throughput capacity","description":"","parameters":[{"name":"belt_speed","in":"query","required":true,"description":"Belt speed v (m/s)","schema":{"type":"string"},"example":"2"},{"name":"cross_section_area","in":"query","required":false,"description":"Load cross-section A (m²)","schema":{"type":"string"},"example":"0.05"},{"name":"belt_width","in":"query","required":false,"description":"Or belt width (m) to estimate A","schema":{"type":"string"}},{"name":"load_factor","in":"query","required":false,"description":"Load factor for width (default 0.11)","schema":{"type":"string"},"example":"0.11"},{"name":"bulk_density","in":"query","required":false,"description":"Bulk density ρ (kg/m³, default 1600)","schema":{"type":"string"},"example":"1600"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Q = A·v·3600 (m³/h); mass = Q·ρ/1000 (t/h). Without an area, A ≈ load_factor·belt_width² (≈0.11 troughed).","inputs":{"belt_speed":2,"bulk_density":1600,"cross_section_area":0.05},"mass_flow_kg_s":160,"mass_capacity_t_h":576,"volumetric_capacity_m3_h":360},"meta":{"timestamp":"2026-06-04T18:38:24.154Z","request_id":"43d06de6-362e-4386-87d3-c80783373eed"},"status":"ok","message":"Conveyor 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/power":{"get":{"operationId":"get_v1_power","tags":["Conveyor"],"summary":"Drive power","description":"","parameters":[{"name":"mass_flow","in":"query","required":true,"description":"Mass flow (t/h)","schema":{"type":"string"},"example":"500"},{"name":"length","in":"query","required":true,"description":"Horizontal length L (m)","schema":{"type":"string"},"example":"100"},{"name":"belt_speed","in":"query","required":true,"description":"Belt speed v (m/s)","schema":{"type":"string"},"example":"2"},{"name":"lift_height","in":"query","required":false,"description":"Lift height H (m, default 0)","schema":{"type":"string"},"example":"10"},{"name":"friction_coefficient","in":"query","required":false,"description":"Friction factor μ (default 0.022)","schema":{"type":"string"},"example":"0.022"},{"name":"belt_mass_per_metre","in":"query","required":false,"description":"Belt mass (kg/m, default 16)","schema":{"type":"string"},"example":"15"},{"name":"idler_mass_per_metre","in":"query","required":false,"description":"Idler mass (kg/m, default 20)","schema":{"type":"string"},"example":"20"},{"name":"efficiency","in":"query","required":false,"description":"Drive efficiency (default 0.9)","schema":{"type":"string"},"example":"0.9"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"P = μ·g·(m_load + 2·m_belt + m_idler)·L·v + ṁ·g·H, then divided by the drive efficiency. Simplified model.","inputs":{"length":100,"belt_speed":2,"efficiency":0.9,"lift_height":10,"mass_flow_t_h":500,"friction_coefficient":0.022},"lift_power_kw":13.625,"motor_power_kw":20.86744,"friction_power_kw":5.1557,"required_power_kw":18.7807,"material_load_kg_per_m":69.4444},"meta":{"timestamp":"2026-06-04T18:38:24.264Z","request_id":"8daec7d7-dd3e-43a7-8567-2bb653f570e3"},"status":"ok","message":"Drive power","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/tension":{"get":{"operationId":"get_v1_tension","tags":["Conveyor"],"summary":"Belt tension","description":"","parameters":[{"name":"power","in":"query","required":false,"description":"Drive power (kW)","schema":{"type":"string"},"example":"20"},{"name":"belt_speed","in":"query","required":false,"description":"Belt speed (m/s) with power","schema":{"type":"string"},"example":"2"},{"name":"effective_tension","in":"query","required":false,"description":"Or effective tension Te (N)","schema":{"type":"string"}},{"name":"drive_friction","in":"query","required":false,"description":"Pulley friction μ (default 0.35)","schema":{"type":"string"},"example":"0.35"},{"name":"wrap_angle","in":"query","required":false,"description":"Wrap angle (degrees, default 210)","schema":{"type":"string"},"example":"210"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Te = P/v. T1 = Te·e^(μθ)/(e^(μθ)−1) (tight), T2 = T1 − Te (slack), from the Euler-Eytelwein drive grip.","inputs":{"wrap_angle":210,"drive_friction":0.35,"effective_tension":10000},"drive_factor":1.383614,"effective_tension_n":10000,"slack_side_tension_n":3836.1419,"tight_side_tension_n":13836.1419},"meta":{"timestamp":"2026-06-04T18:38:24.354Z","request_id":"88ed51d8-ac0c-49c8-98a0-20df0fa1cdb2"},"status":"ok","message":"Belt tension","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":"Speed in m/s, length and height in m, mass flow in t/h, tension in N. Simplified engineering model — not a full DIN 22101 / CEMA calculation (no idler-spacing, sag or temperature factors).","service":"conveyor-api","formulae":{"power":"P = μ·g·(m_load + 2·m_belt + m_idler)·L·v + ṁ·g·H","tension":"Te = P/v,  T1 = Te·e^(μθ)/(e^(μθ)−1),  T2 = T1 − Te","capacity":"Q = A·v·3600 (m³/h),  mass = Q·ρ/1000 (t/h)"},"endpoints":{"GET /v1/meta":"This document.","GET /v1/power":"Drive power from the mass flow, length, lift, belt speed and friction.","GET /v1/tension":"Tight- and slack-side belt tensions from the effective tension and drive wrap.","GET /v1/capacity":"Volumetric (m³/h) and mass (t/h) capacity from belt speed, cross-section (or width) and bulk density."},"description":"Belt-conveyor design calculator: throughput capacity, drive power (friction + lift) and belt tensions for a troughed belt conveyor."},"meta":{"timestamp":"2026-06-04T18:38:24.419Z","request_id":"d02f4160-269c-4245-8c8e-2ae58d1bcbf4"},"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":2000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":18000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":90000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7500,"monthly_call_quota":400000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/conveyor-api"}