{"openapi":"3.1.0","info":{"title":"Inductance API","version":"1.0.0","description":"Inductor-design electromagnetics as an API, computed locally and deterministically. The solenoid endpoint computes the inductance of a straight coil with the long-solenoid formula L = μ₀·μr·N²·A/l, from the number of turns, the coil length, the cross-sectional area (or diameter) and the relative permeability of the core — a ferromagnetic core multiplies the inductance. The toroid endpoint computes the inductance of a doughnut-shaped coil of rectangular cross-section, L = μ₀·μr·N²·h·ln(b/a)/(2π), from the turns, the axial height and the inner and outer radii; the toroidal shape confines the magnetic flux so there is little stray field. The energy endpoint computes the magnetic energy stored in an inductor, E = ½·L·I², and the flux linkage Φ = L·I, from the inductance and current — the energy released when the current is interrupted causes the inductive kick. Lengths are in metres, area in square metres, inductance in henries (millihenries and microhenries also returned) and current in amps, with μ₀ = 4π×10⁻⁷ H/m. Everything is computed locally and deterministically, so it is instant and private. Ideal for electronics, RF, power-supply, filter and motor-design app developers, coil-winding and inductor-sizing tools, and electromagnetics education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is inductance from geometry; for the resonant frequency and reactance use a resonance API and for full AC impedance an impedance API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/inductance-api","description":"oanor gateway"}],"tags":[{"name":"Inductance"},{"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":["Inductance"],"summary":"Stored energy","description":"","parameters":[{"name":"inductance","in":"query","required":true,"description":"Inductance (H)","schema":{"type":"string"},"example":"0.001"},{"name":"current","in":"query","required":true,"description":"Current (A)","schema":{"type":"string"},"example":"2"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Energy stored in the magnetic field E = ½·L·I²; flux linkage Φ = L·I. The energy is released when the current is interrupted (hence inductive kick).","inputs":{"current_a":2,"inductance_h":0.001},"energy_mj":2,"energy_joules":0.002,"flux_linkage_wb":0.002},"meta":{"timestamp":"2026-06-05T11:30:31.047Z","request_id":"2b62a364-d163-4d32-819f-aa132c170523"},"status":"ok","message":"Stored 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/solenoid":{"get":{"operationId":"get_v1_solenoid","tags":["Inductance"],"summary":"Solenoid inductance","description":"","parameters":[{"name":"turns","in":"query","required":true,"description":"Number of turns N","schema":{"type":"string"},"example":"100"},{"name":"length","in":"query","required":true,"description":"Coil length (m)","schema":{"type":"string"},"example":"0.1"},{"name":"area","in":"query","required":false,"description":"Cross-sectional area (m²)","schema":{"type":"string"},"example":"0.0001"},{"name":"diameter","in":"query","required":false,"description":"Or diameter (m)","schema":{"type":"string"}},{"name":"relative_permeability","in":"query","required":false,"description":"Core μr","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Long-solenoid inductance L = μ₀·μr·N²·A/l, accurate when the length is much greater than the diameter. A ferromagnetic core (μr ≫ 1) multiplies the inductance.","inputs":{"turns":100,"area_m2":0.0001,"length_m":0.1,"relative_permeability":1},"inductance_h":1.2566370614e-5,"inductance_mh":0.012566371,"inductance_uh":12.566371},"meta":{"timestamp":"2026-06-05T11:30:31.147Z","request_id":"59632ddf-f540-429c-bf57-a09647d0e859"},"status":"ok","message":"Solenoid inductance","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/toroid":{"get":{"operationId":"get_v1_toroid","tags":["Inductance"],"summary":"Toroid inductance","description":"","parameters":[{"name":"turns","in":"query","required":true,"description":"Number of turns N","schema":{"type":"string"},"example":"200"},{"name":"height","in":"query","required":true,"description":"Axial height (m)","schema":{"type":"string"},"example":"0.01"},{"name":"inner_radius","in":"query","required":true,"description":"Inner radius a (m)","schema":{"type":"string"},"example":"0.05"},{"name":"outer_radius","in":"query","required":true,"description":"Outer radius b (m)","schema":{"type":"string"},"example":"0.06"},{"name":"relative_permeability","in":"query","required":false,"description":"Core μr","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Rectangular-cross-section toroid L = μ₀·μr·N²·h·ln(b/a)/(2π). The toroidal shape confines the flux, so there is little external field.","inputs":{"turns":200,"height_m":0.01,"inner_radius_m":0.05,"outer_radius_m":0.06,"relative_permeability":1},"inductance_h":1.4585724544e-5,"inductance_mh":0.014585725,"inductance_uh":14.585725},"meta":{"timestamp":"2026-06-05T11:30:31.259Z","request_id":"cee64f35-0a8c-4911-bad6-da76fdbe3472"},"status":"ok","message":"Toroid inductance","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":"Lengths and radii in m, area in m², inductance in H (mH/µH also returned), current in A. μ₀ = 4π×10⁻⁷ H/m; relative permeability defaults to 1 (air core).","service":"inductance-api","formulae":{"energy":"E = ½·L·I²","toroid":"L = μ₀·μr·N²·h·ln(b/a)/(2π)","solenoid":"L = μ₀·μr·N²·A/l"},"constants":{"mu0_h_per_m":1.2566370614359173e-6},"endpoints":{"GET /v1/meta":"This document.","GET /v1/energy":"Stored magnetic energy and flux linkage from inductance and current.","GET /v1/toroid":"Toroid inductance from turns, height, inner/outer radius and permeability.","GET /v1/solenoid":"Solenoid inductance from turns, length, area/diameter and core permeability."},"description":"Inductance calculator from coil geometry: solenoid and toroid inductance, and the magnetic energy stored in an inductor."},"meta":{"timestamp":"2026-06-05T11:30:31.364Z","request_id":"f1341cdd-6f59-4a86-b94a-c5d88358b42b"},"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":2700,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":37000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2100,"monthly_call_quota":248000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6600,"monthly_call_quota":1590000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/inductance-api"}