{"openapi":"3.1.0","info":{"title":"Pressure Vessel API","version":"1.0.0","description":"Thin-walled pressure-vessel engineering maths as an API, computed locally and deterministically. The thin-wall endpoint computes the wall stresses in a cylindrical or spherical vessel under internal pressure: for a cylinder the hoop (circumferential) stress σ_h = p·r/t and the longitudinal stress σ_l = p·r/(2t), which is half the hoop — so cylinders tend to split along their length — together with the von Mises equivalent stress, and for a sphere the single biaxial stress σ = p·r/(2t); it also reports the radius-to-thickness ratio and whether the thin-wall assumption (r/t ≳ 10) holds. The thickness endpoint computes the wall thickness required to keep the hoop stress within an allowable value, t = p·r/(σ_allow·E), with a weld-joint efficiency factor. The burst endpoint computes the theoretical burst pressure of a pipe from Barlow's formula, p = 2·S·t/OD, using the ultimate tensile strength. Pressures and stresses are in pascals (megapascals also returned) and dimensions in metres. Everything is computed locally and deterministically, so it is instant and private. Ideal for mechanical, chemical-plant, piping, boiler and tank-design app developers, ASME-style sizing and safety tools, and engineering education; for code work consult the applicable standards. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is thin-walled vessel stress; for general stress transformation use a Mohr-circle API and for fatigue a fatigue API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/pressurevessel-api","description":"oanor gateway"}],"tags":[{"name":"PressureVessel"},{"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/burst":{"get":{"operationId":"get_v1_burst","tags":["PressureVessel"],"summary":"Barlow burst pressure","description":"","parameters":[{"name":"ultimate_strength","in":"query","required":true,"description":"Ultimate tensile strength (Pa)","schema":{"type":"string"},"example":"400000000"},{"name":"thickness","in":"query","required":true,"description":"Wall thickness (m)","schema":{"type":"string"},"example":"0.01"},{"name":"outer_diameter","in":"query","required":true,"description":"Outer diameter (m)","schema":{"type":"string"},"example":"1.02"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Barlow's formula p = 2·S·t/OD gives the theoretical burst pressure of a thin-walled pipe using the ultimate tensile strength. Apply a design factor for the working pressure.","inputs":{"thickness_m":0.01,"outer_diameter_m":1.02,"ultimate_strength_pa":400000000},"burst_pressure_pa":7843137.2549,"burst_pressure_bar":78.4314,"burst_pressure_mpa":7.843137},"meta":{"timestamp":"2026-06-05T11:30:27.601Z","request_id":"24ed00a5-53b9-4a54-9891-334329c8234e"},"status":"ok","message":"Burst pressure","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/thickness":{"get":{"operationId":"get_v1_thickness","tags":["PressureVessel"],"summary":"Required thickness","description":"","parameters":[{"name":"pressure","in":"query","required":true,"description":"Internal pressure (Pa)","schema":{"type":"string"},"example":"2000000"},{"name":"radius","in":"query","required":true,"description":"Inner radius (m)","schema":{"type":"string"},"example":"0.5"},{"name":"allowable_stress","in":"query","required":true,"description":"Allowable stress (Pa)","schema":{"type":"string"},"example":"120000000"},{"name":"joint_efficiency","in":"query","required":false,"description":"Weld-joint efficiency (0–1)","schema":{"type":"string"},"example":"1"},{"name":"shape","in":"query","required":false,"description":"cylinder or sphere","schema":{"type":"string"},"example":"cylinder"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Required cylinder thickness t = p·r/(σ_allow·E) (hoop stress governs). E is the weld-joint efficiency.","inputs":{"shape":"cylinder","radius_m":0.5,"pressure_pa":2000000,"joint_efficiency":1,"allowable_stress_pa":120000000},"required_thickness_m":0.00833333,"required_thickness_mm":8.33333},"meta":{"timestamp":"2026-06-05T11:30:27.721Z","request_id":"d5c3009b-67d1-48c9-b6b7-4caa8ae9b8f1"},"status":"ok","message":"Required thickness","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/thin-wall":{"get":{"operationId":"get_v1_thin_wall","tags":["PressureVessel"],"summary":"Thin-wall stress","description":"","parameters":[{"name":"pressure","in":"query","required":true,"description":"Internal pressure (Pa)","schema":{"type":"string"},"example":"2000000"},{"name":"radius","in":"query","required":true,"description":"Inner radius (m)","schema":{"type":"string"},"example":"0.5"},{"name":"thickness","in":"query","required":true,"description":"Wall thickness (m)","schema":{"type":"string"},"example":"0.01"},{"name":"shape","in":"query","required":false,"description":"cylinder or sphere","schema":{"type":"string"},"example":"cylinder"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Thin-walled cylinder: hoop (circumferential) stress σ_h = p·r/t is twice the longitudinal σ_l = p·r/(2t), so cylinders fail along their length. Thin-wall theory assumes r/t ≳ 10.","inputs":{"shape":"cylinder","radius_m":0.5,"pressure_pa":2000000,"thickness_m":0.01},"hoop_stress_pa":100000000,"hoop_stress_mpa":100,"thin_wall_valid":true,"von_mises_stress_mpa":86.60254,"longitudinal_stress_pa":50000000,"longitudinal_stress_mpa":50,"radius_to_thickness_ratio":50},"meta":{"timestamp":"2026-06-05T11:30:27.820Z","request_id":"d5d779d4-18f4-4a09-b546-53cb091b453f"},"status":"ok","message":"Thin-wall stress","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":"Pressure and stresses in Pa (MPa also returned), radius/thickness/diameter in m. Thin-wall theory assumes r/t ≳ 10. Joint efficiency E defaults to 1.","service":"pressurevessel-api","formulae":{"hoop":"σ_h = p·r/t","barlow":"p = 2·S·t/OD","thickness":"t = p·r/(σ_allow·E)","longitudinal":"σ_l = p·r/(2t)"},"endpoints":{"GET /v1/meta":"This document.","GET /v1/burst":"Barlow burst pressure from ultimate strength, thickness and outer diameter.","GET /v1/thickness":"Required wall thickness for an allowable stress and joint efficiency.","GET /v1/thin-wall":"Hoop, longitudinal and von Mises stress from pressure, radius and thickness."},"description":"Thin-walled pressure-vessel calculator: hoop and longitudinal stress in a cylinder or sphere, the required wall thickness for an allowable stress, and the Barlow burst pressure."},"meta":{"timestamp":"2026-06-05T11:30:27.909Z","request_id":"258cbf49-3231-4c25-a7d8-1b0ec1c327d7"},"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":2350,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":37500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2600,"monthly_call_quota":247000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7900,"monthly_call_quota":1660000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/pressurevessel-api"}