{"openapi":"3.1.0","info":{"title":"Septic System API","version":"1.0.0","description":"Septic-system sizing as an API, computed locally and deterministically with the typical US onsite-wastewater rules of thumb. The flow endpoint estimates the design wastewater flow for a home from its number of bedrooms (assuming two people per bedroom) or an explicit occupancy, at a default 60 gallons per person per day, returning the daily flow in US gallons and litres. The tank endpoint recommends a septic tank size as the larger of a retention-based size (flow × retention days, default two days) and the typical bedroom-based code minimum (≤3 bedrooms 1,000, 4 bedrooms 1,200, 5 bedrooms 1,500, 6 bedrooms 2,000 US gallons), and tells you which one governs. The drainfield endpoint sizes the soil absorption (leach) field: it divides the daily flow by a soil loading rate — given directly or looked up from a percolation rate in minutes per inch — to get the absorption area, then divides by the trench width to get the trench length, in both imperial and metric. Everything is computed locally and deterministically, so it is instant and private. An estimating aid, not a code-stamped design — always confirm with your local health authority. Ideal for plumbing and septic-installer tools, rural real-estate and land apps, home-building and permitting calculators, and inspection software. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is septic / onsite-wastewater sizing; for storage-tank volume and fill level use a tank API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/septic-api","description":"oanor gateway"}],"tags":[{"name":"Septic"},{"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/drainfield":{"get":{"operationId":"get_v1_drainfield","tags":["Septic"],"summary":"Drain field area & trench","description":"","parameters":[{"name":"bedrooms","in":"query","required":false,"description":"Bedrooms (for flow)","schema":{"type":"string"},"example":"3"},{"name":"daily_flow","in":"query","required":false,"description":"Or explicit flow (gpd)","schema":{"type":"string"}},{"name":"perc_rate","in":"query","required":false,"description":"Percolation (minutes/inch)","schema":{"type":"string"},"example":"20"},{"name":"loading_rate","in":"query","required":false,"description":"Or soil loading rate (gpd/ft²)","schema":{"type":"string"}},{"name":"trench_width_ft","in":"query","required":false,"description":"Trench width (ft, default 2)","schema":{"type":"string"},"example":"2"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Absorption area = daily flow ÷ soil loading rate. Loading rate from perc: ≤5→1.2, ≤10→1.0, ≤15→0.8, ≤30→0.6, ≤45→0.5, ≤60→0.4 gpd/ft². Trench length = area ÷ trench width.","daily_flow":{"litres":1362.7,"us_gallons":360},"trench_length":{"m":91.44,"ft":300},"loading_source":"perc 20 min/in","absorption_area":{"m2":55.74,"ft2":600},"trench_width_ft":2,"loading_rate_gpd_ft2":0.6},"meta":{"timestamp":"2026-06-04T01:59:08.868Z","request_id":"bccd4bda-7185-45e5-b040-53a7f430374d"},"status":"ok","message":"Drain field area & trench 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/flow":{"get":{"operationId":"get_v1_flow","tags":["Septic"],"summary":"Daily wastewater flow","description":"","parameters":[{"name":"bedrooms","in":"query","required":false,"description":"Number of bedrooms","schema":{"type":"string"},"example":"3"},{"name":"occupants","in":"query","required":false,"description":"Or number of occupants","schema":{"type":"string"}},{"name":"per_person_gpd","in":"query","required":false,"description":"Gallons per person per day (default 60)","schema":{"type":"string"}},{"name":"daily_flow","in":"query","required":false,"description":"Or an explicit flow (gpd)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Estimated design flow. Default 60 gpd/person; bedrooms assume 2 persons each. Local codes vary — check your jurisdiction.","basis":"3 bedrooms × 2 persons × 60 gpd","daily_flow":{"litres":1362.7,"us_gallons":360}},"meta":{"timestamp":"2026-06-04T01:59:08.948Z","request_id":"3bea25c7-70ea-4bb1-88fe-ff73e609061c"},"status":"ok","message":"Daily wastewater flow estimate","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/tank":{"get":{"operationId":"get_v1_tank","tags":["Septic"],"summary":"Recommended septic tank size","description":"","parameters":[{"name":"bedrooms","in":"query","required":false,"description":"Bedrooms (for code minimum)","schema":{"type":"string"},"example":"3"},{"name":"occupants","in":"query","required":false,"description":"Or occupants","schema":{"type":"string"}},{"name":"daily_flow","in":"query","required":false,"description":"Or explicit flow (gpd)","schema":{"type":"string"}},{"name":"retention_days","in":"query","required":false,"description":"Retention days (default 2)","schema":{"type":"string"},"example":"2"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Recommended = larger of (flow × retention days) and the typical bedroom-based minimum. Standard minimums: ≤3 BR 1000, 4 BR 1200, 5 BR 1500, 6 BR 2000 US gal.","bedrooms":3,"governing":"bedroom_minimum","daily_flow":{"litres":1362.7,"us_gallons":360},"retention_days":2,"bedroom_minimum":{"litres":3785.4,"us_gallons":1000},"retention_based_size":{"litres":2725.5,"us_gallons":720},"recommended_tank_size":{"litres":3785.4,"us_gallons":1000}},"meta":{"timestamp":"2026-06-04T01:59:09.043Z","request_id":"a76e2ffc-4cab-4ac6-ab60-f1aba866adde"},"status":"ok","message":"Recommended septic tank size","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":{"api":"septic","note":"Septic system sizing — typical US onsite-wastewater rules of thumb, computed locally and deterministically. An estimating aid, not a code-stamped design; always confirm with the local health authority.","defaults":{"per_person_gpd":60,"retention_days":2,"trench_width_ft":2,"persons_per_bedroom":2},"endpoints":["/v1/flow","/v1/tank","/v1/drainfield","/v1/meta"]},"meta":{"timestamp":"2026-06-04T01:59:09.143Z","request_id":"5498524a-6e2a-4c25-9912-f9ef7cdb8d1c"},"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":13635,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1515,"monthly_call_quota":23350,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3525,"monthly_call_quota":283500,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7325,"monthly_call_quota":1460000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/septic-api"}