{"openapi":"3.1.0","info":{"title":"Lighting Calculator API","version":"1.0.0","description":"Lighting design maths as an API, computed locally and deterministically. The room endpoint works out how many lumens a room needs from its area and a target illuminance — given directly in lux or chosen from a room-type preset (living, kitchen, office, workshop and more) — and, optionally, how many fixtures at a given lumen output and how many watts at a given lamp type. The lux endpoint converts between lux, footcandles and lumens over an area, so you can find the illuminance from a light output and a room size or vice versa. The efficacy endpoint relates lumens, watts and luminous efficacy (lumens per watt): give any two — or a lamp-type preset such as incandescent, halogen, CFL or LED — and it computes the third. Everything is computed locally and deterministically, so it is instant and private. It is a lumen-method estimate: target levels are typical guidance (EN 12464 / IES) and a full design would add room and utilisation factors. Ideal for lighting and electrical tools, interior-design and home apps, retrofit and energy-saving calculators, and smart-home planning. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is illumination maths; for Ohm's-law electrical quantities use an electronics API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/lighting-api","description":"oanor gateway"}],"tags":[{"name":"Lighting"},{"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/efficacy":{"get":{"operationId":"get_v1_efficacy","tags":["Lighting"],"summary":"Lumens / watts / efficacy","description":"","parameters":[{"name":"lumens","in":"query","required":false,"description":"Lumens","schema":{"type":"string"},"example":"800"},{"name":"watts","in":"query","required":false,"description":"Watts","schema":{"type":"string"}},{"name":"efficacy","in":"query","required":false,"description":"lm/W","schema":{"type":"string"}},{"name":"bulb_type","in":"query","required":false,"description":"led|cfl|halogen|incandescent","schema":{"type":"string"},"example":"led"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Luminous efficacy (lm/W) relates light output to power. Presets: incandescent 14, halogen 20, CFL 60, fluorescent 80, LED 90.","input":{"lumens":800,"efficacy":90,"bulb_type":"led"},"watts":8.89,"lumens":800,"efficacy_lm_per_w":90},"meta":{"timestamp":"2026-06-03T17:41:54.976Z","request_id":"d984cdaa-8a91-4936-8db7-d10c68c4d598"},"status":"ok","message":"Lumens / watts / efficacy","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/lux":{"get":{"operationId":"get_v1_lux","tags":["Lighting"],"summary":"Lux / footcandle / lumens","description":"","parameters":[{"name":"lumens","in":"query","required":false,"description":"Light output","schema":{"type":"string"},"example":"10000"},{"name":"area","in":"query","required":false,"description":"Area m²","schema":{"type":"string"},"example":"20"},{"name":"lux","in":"query","required":false,"description":"Or a lux value","schema":{"type":"string"}},{"name":"footcandles","in":"query","required":false,"description":"Or footcandles","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"lux":500,"note":"Illuminance: lux = lumens ÷ area (m²). 1 footcandle = 10.764 lux.","lumens":10000,"area_m2":20,"footcandles":46.452},"meta":{"timestamp":"2026-06-03T17:41:55.055Z","request_id":"63b2be74-18fa-48f9-ba68-6670be433643"},"status":"ok","message":"Lux / footcandle conversion","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/room":{"get":{"operationId":"get_v1_room","tags":["Lighting"],"summary":"Lumens needed for a room","description":"","parameters":[{"name":"area","in":"query","required":false,"description":"Area (or length+width)","schema":{"type":"string"},"example":"20"},{"name":"area_unit","in":"query","required":false,"description":"sqm|sqft","schema":{"type":"string"},"example":"sqm"},{"name":"room_type","in":"query","required":false,"description":"office|kitchen|living|…","schema":{"type":"string"},"example":"office"},{"name":"lux","in":"query","required":false,"description":"Or explicit target lux","schema":{"type":"string"}},{"name":"lumens_per_fixture","in":"query","required":false,"description":"For fixture count","schema":{"type":"string"}},{"name":"bulb_type","in":"query","required":false,"description":"led|cfl|halogen|incandescent (for watts)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Lumens = area (m²) × target lux. Target levels are typical guidance; this is a lumen-method estimate (no room/utilisation factors).","input":{"area_m2":20,"room_type":"office","target_lux":500},"footcandles":46.45,"total_lumens":10000,"lumens_per_m2":500},"meta":{"timestamp":"2026-06-03T17:41:55.144Z","request_id":"f7ebaef5-be73-4c75-901c-6149c4d52ed6"},"status":"ok","message":"Lumens for a room","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":{"note":"Lumen-method estimate; target levels are typical guidance (EN 12464 / IES). Add room/utilisation factors for a full design.","service":"lighting","endpoints":{"/v1/lux":"Convert between lux, footcandles and lumens over an area.","/v1/room":"Total lumens (and fixtures/watts) for a room from its area and a target lux or room type.","/v1/efficacy":"Convert between lumens, watts and luminous efficacy (lm/W), with lamp-type presets."},"bulb_types":["incandescent","halogen","cfl","fluorescent","led","hps","sodium"],"room_types":["living","lounge","bedroom","hallway","corridor","garage","closet","kitchen","bathroom","diningroom","laundry","stairs","office","study","classroom","retail","workshop","kitchencounter","warehouse","supermarket","drawingoffice","surgery","garageworkshop"],"description":"Lighting maths: lumens needed for a room, lux/footcandle conversion, and lumens↔watts via luminous efficacy."},"meta":{"timestamp":"2026-06-03T17:41:55.239Z","request_id":"4b96a35e-f853-4b05-b7c2-6917d6127150"},"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":10335,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1185,"monthly_call_quota":19950,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3175,"monthly_call_quota":249500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6975,"monthly_call_quota":1290000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/lighting-api"}