{"openapi":"3.1.0","info":{"title":"Blast Effects API","version":"1.0.0","description":"Blast-effects and TNT-equivalence maths as an API for safety engineering and education, computed locally and deterministically. The energy endpoint converts between a TNT charge mass and the energy it releases using the conventional 4.184 MJ per kilogram, in both directions, including the kiloton equivalent. The scaled-distance endpoint computes the Hopkinson-Cranz scaled distance Z = R / W^(1/3) from a standoff distance and a charge weight — the cube-root scaling law means two blasts with the same Z produce the same overpressure — and inverts it to give the standoff distance for a target Z, which is how safety distances are set for a given charge. The overpressure endpoint estimates the peak side-on overpressure with the Brode (1955) correlation from the scaled distance (or from distance and charge), in kilopascals, bar and psi, with a qualitative damage assessment from shattered glass to structural collapse. Charge is in kilograms of TNT, distance in metres and energy in joules. Everything is computed locally and deterministically, so it is instant and private. Ideal for blast-resistant design, demolition, mining, process-safety and emergency-planning app developers, standoff-distance and overpressure tools, and engineering education; for engineering use, consult the applicable standards. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is explosive blast effects; for earthquake magnitude and energy use an earthquake-magnitude API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tnt-api","description":"oanor gateway"}],"tags":[{"name":"Blast"},{"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/energy":{"get":{"operationId":"get_v1_energy","tags":["Blast"],"summary":"TNT energy","description":"","parameters":[{"name":"mass","in":"query","required":false,"description":"TNT mass (kg)","schema":{"type":"string"},"example":"1000"},{"name":"energy","in":"query","required":false,"description":"Or energy (J) for the TNT equivalent","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"1 kg of TNT releases 4.184 MJ (the conventional value). 1 kiloton = 10⁶ kg TNT = 4.184 TJ.","inputs":{"mass_kg":1000},"energy_gj":4.184,"energy_mj":4184,"tnt_kilotons":0.001,"energy_joules":4184000000},"meta":{"timestamp":"2026-06-05T11:30:31.499Z","request_id":"32b85eb7-00ab-4951-95cf-58eda3fdba7e"},"status":"ok","message":"TNT energy","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/overpressure":{"get":{"operationId":"get_v1_overpressure","tags":["Blast"],"summary":"Peak overpressure","description":"","parameters":[{"name":"distance","in":"query","required":false,"description":"Standoff distance (m)","schema":{"type":"string"},"example":"50"},{"name":"charge","in":"query","required":false,"description":"Charge (kg TNT)","schema":{"type":"string"},"example":"1000"},{"name":"scaled_distance","in":"query","required":false,"description":"Or scaled distance Z","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Peak side-on overpressure via the Brode (1955) correlation from the scaled distance. For safety-distance and blast-resistant-design estimates; consult standards for engineering use.","inputs":{"charge_kg":1000,"distance_m":50,"scaled_distance":5},"damage_assessment":"houses badly damaged, eardrum rupture risk","peak_overpressure_bar":0.281,"peak_overpressure_kpa":28.1,"peak_overpressure_psi":4.0756},"meta":{"timestamp":"2026-06-05T11:30:31.613Z","request_id":"d1b0da4d-f06e-4afa-9945-2814b22e8bc9"},"status":"ok","message":"Peak overpressure","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/scaled-distance":{"get":{"operationId":"get_v1_scaled_distance","tags":["Blast"],"summary":"Scaled distance","description":"","parameters":[{"name":"distance","in":"query","required":false,"description":"Standoff distance (m)","schema":{"type":"string"},"example":"50"},{"name":"charge","in":"query","required":true,"description":"Charge (kg TNT)","schema":{"type":"string"},"example":"1000"},{"name":"scaled_distance","in":"query","required":false,"description":"Or Z to get the distance","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Hopkinson-Cranz scaled distance Z = R / W^(1/3) (m/kg^⅓). Blasts with equal Z produce the same overpressure — the cube-root scaling law.","inputs":{"charge_kg":1000,"distance_m":50},"scaled_distance":5},"meta":{"timestamp":"2026-06-05T11:30:31.722Z","request_id":"60dfcad5-f043-4a16-9ae0-01deecfd93d0"},"status":"ok","message":"Scaled distance","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":"Charge in kg TNT, distance in m, energy in J, overpressure in kPa/bar/psi. The cube-root law means equal Z gives equal overpressure. For education and first-order safety estimates.","service":"tnt-api","formulae":{"energy":"E = mass · 4.184 MJ/kg","overpressure":"Brode (1955): ΔP(bar) from Z","scaled_distance":"Z = R / W^(1/3)"},"endpoints":{"GET /v1/meta":"This document.","GET /v1/energy":"Energy from a TNT mass, or the TNT equivalent of an energy.","GET /v1/overpressure":"Peak overpressure and damage assessment from scaled distance (or distance + charge).","GET /v1/scaled-distance":"Hopkinson-Cranz scaled distance Z from standoff and charge (or the inverse)."},"description":"Blast-effects calculator (safety engineering): TNT-equivalent energy, Hopkinson-Cranz scaled distance and Brode peak overpressure with a damage assessment."},"meta":{"timestamp":"2026-06-05T11:30:31.815Z","request_id":"6c883074-1895-4a34-9a1f-66c9fe500c77"},"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":2600,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":36000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2700,"monthly_call_quota":250000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8200,"monthly_call_quota":1720000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tnt-api"}