{"openapi":"3.1.0","info":{"title":"Transmission Line API","version":"1.0.0","description":"Transmission-line RF maths as an API, computed locally and deterministically for a lossless line. The input-impedance endpoint transforms a complex load impedance along a line, Zin = Z0·(ZL + jZ0·tanβl)/(Z0 + jZL·tanβl), from the characteristic impedance, the load resistance and reactance and the electrical length in degrees — a quarter-wave (90°) line inverts the load to Z0²/ZL while a half-wave (180°) line repeats it, which is the basis of impedance matching. The quarter-wave endpoint computes the characteristic impedance Z0 = √(Z1·Z2) of a quarter-wave transformer that matches two real impedances, exact at one frequency. The electrical-length endpoint converts a physical line length to its electrical length in wavelengths, degrees and radians at a frequency, using the on-line wavelength λ = vf·c/f with a velocity factor for the dielectric. Impedances are in ohms (the load split into resistance and reactance), electrical length in degrees, physical length in metres and frequency in hertz. Everything is computed locally and deterministically, so it is instant and private. Ideal for RF, antenna-matching, PCB, radar and microwave app developers, stub-matching and transformer-design tools, and electromagnetics education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is line impedance transformation; for SWR and return loss use a VSWR API and for microstrip trace geometry a PCB API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/transmissionline-api","description":"oanor gateway"}],"tags":[{"name":"TransmissionLine"},{"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/electrical-length":{"get":{"operationId":"get_v1_electrical_length","tags":["TransmissionLine"],"summary":"Electrical length","description":"","parameters":[{"name":"length","in":"query","required":true,"description":"Physical length (m)","schema":{"type":"string"},"example":"0.05"},{"name":"frequency","in":"query","required":true,"description":"Frequency (Hz)","schema":{"type":"string"},"example":"3000000000"},{"name":"velocity_factor","in":"query","required":false,"description":"Velocity factor (0–1)","schema":{"type":"string"},"example":"0.66"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Wavelength on the line λ = vf·c/f (velocity factor accounts for the dielectric). Electrical length = physical length / λ, in wavelengths, degrees and radians.","inputs":{"length_m":0.05,"frequency_hz":3000000000,"velocity_factor":0.66},"wavelength_m":0.065954341,"electrical_length_deg":272.916078,"electrical_length_rad":4.76328414,"length_in_wavelengths":0.7581},"meta":{"timestamp":"2026-06-05T11:30:29.779Z","request_id":"d2df8516-58ad-4370-a19b-c1cab8ee496a"},"status":"ok","message":"Electrical length","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/input-impedance":{"get":{"operationId":"get_v1_input_impedance","tags":["TransmissionLine"],"summary":"Input impedance","description":"","parameters":[{"name":"characteristic_impedance","in":"query","required":true,"description":"Z0 (Ω)","schema":{"type":"string"},"example":"50"},{"name":"load_resistance","in":"query","required":true,"description":"Load resistance RL (Ω)","schema":{"type":"string"},"example":"100"},{"name":"load_reactance","in":"query","required":false,"description":"Load reactance XL (Ω)","schema":{"type":"string"},"example":"0"},{"name":"electrical_length_deg","in":"query","required":true,"description":"Electrical length βl (deg)","schema":{"type":"string"},"example":"45"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Lossless-line transform Zin = Z0·(ZL + jZ0·tanβl)/(Z0 + jZL·tanβl). A quarter-wave line (90°) inverts the load to Z0²/ZL; a half-wave line (180°) repeats it.","inputs":{"load_reactance":0,"load_resistance":100,"electrical_length_deg":45,"characteristic_impedance":50},"input_reactance":-30,"input_resistance":40,"input_impedance_magnitude":50},"meta":{"timestamp":"2026-06-05T11:30:29.893Z","request_id":"0a7a133c-23a1-45f1-9c43-d269980be8cf"},"status":"ok","message":"Input impedance","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/quarter-wave":{"get":{"operationId":"get_v1_quarter_wave","tags":["TransmissionLine"],"summary":"Quarter-wave transformer","description":"","parameters":[{"name":"source_impedance","in":"query","required":true,"description":"Source impedance Z1 (Ω)","schema":{"type":"string"},"example":"50"},{"name":"load_impedance","in":"query","required":true,"description":"Load impedance Z2 (Ω)","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"A quarter-wave (90°) transformer of characteristic impedance Z0 = √(Z1·Z2) matches two real impedances. It only matches resistive loads and is exact at one frequency.","inputs":{"load_impedance":100,"source_impedance":50},"transformer_impedance":70.710678},"meta":{"timestamp":"2026-06-05T11:30:29.972Z","request_id":"549932d3-9356-4d74-a64e-fabf43a44992"},"status":"ok","message":"Quarter-wave transformer","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":"Impedances in Ω (load as resistance + reactance), electrical length in degrees, physical length in m, frequency in Hz. Lossless line. Velocity factor 0–1 (default 1).","service":"transmissionline-api","formulae":{"wavelength":"λ = vf·c/f","quarter_wave":"Z0' = √(Z1·Z2)","input_impedance":"Zin = Z0·(ZL + jZ0·tanβl)/(Z0 + jZL·tanβl)"},"endpoints":{"GET /v1/meta":"This document.","GET /v1/quarter-wave":"Quarter-wave transformer impedance to match two real impedances.","GET /v1/input-impedance":"Input impedance of a line from Z0, the complex load and the electrical length.","GET /v1/electrical-length":"Electrical length (wavelengths/degrees) from physical length, frequency and velocity factor."},"description":"Transmission-line calculator: input impedance of a loaded lossless line, quarter-wave matching-transformer impedance, and physical-to-electrical length conversion."},"meta":{"timestamp":"2026-06-05T11:30:30.069Z","request_id":"65e33f9e-4427-48bb-997a-d21859ca31a7"},"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":2450,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1000,"monthly_call_quota":40500,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2600,"monthly_call_quota":258000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8100,"monthly_call_quota":1710000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/transmissionline-api"}