{"openapi":"3.1.0","info":{"title":"MN Comp Buddy public calculation API","version":"2026-07","description":"Free, read-only Minnesota workers' compensation benefit calculations using official DLI rates and Minn. Stat. ch. 176 formulas. No authentication, no signup, no PII stored. Rates verified through 2025-10-01. Every response includes the formula used and statute citations. Informational estimate under Minnesota law only, not legal advice. Verify against the cited statute and the MN DLI rate tables.","contact":{"url":"https://www.mncompbuddy.com/about"}},"servers":[{"url":"https://www.mncompbuddy.com"}],"paths":{"/api/calculate/ttd":{"get":{"summary":"Temporary total disability (TTD) weekly rate","description":"Two-thirds of the average weekly wage, clamped to the statutory minimum and maximum for the date of injury. Minn. Stat. 176.101, subd. 1.","parameters":[{"name":"doi","in":"query","required":true,"description":"Date of injury (YYYY-MM-DD)","schema":{"type":"string"},"example":"2025-10-01"},{"name":"aww","in":"query","required":true,"description":"Gross average weekly wage in dollars","schema":{"type":"string"},"example":"1200"}],"responses":{"200":{"description":"Calculation result with formula, sources, and rate metadata","content":{"application/json":{"schema":{"type":"object","properties":{"calculator":{"type":"string"},"version":{"type":"string"},"ratesVerifiedThrough":{"type":"string","format":"date"},"lawVerifiedThrough":{"type":"string","format":"date"},"input":{"type":"object"},"result":{"type":"object"},"formula":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}}},"docs":{"type":"string"},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"hint":{"type":"string"},"docs":{"type":"string"}}}}}}}}},"/api/calculate/tpd":{"get":{"summary":"Temporary partial disability (TPD) weekly rate","description":"Two-thirds of the gap between the pre-injury wage and current earnings, subject to the TTD maximum and the 500%-of-SAWW combined cap. Minn. Stat. 176.101, subd. 2.","parameters":[{"name":"doi","in":"query","required":true,"description":"Date of injury (YYYY-MM-DD)","schema":{"type":"string"},"example":"2025-10-01"},{"name":"aww","in":"query","required":true,"description":"Gross average weekly wage in dollars","schema":{"type":"string"},"example":"1200"},{"name":"postInjuryWeeklyWage","in":"query","required":true,"description":"Current gross weekly earnings in dollars","schema":{"type":"string"},"example":"600"}],"responses":{"200":{"description":"Calculation result with formula, sources, and rate metadata","content":{"application/json":{"schema":{"type":"object","properties":{"calculator":{"type":"string"},"version":{"type":"string"},"ratesVerifiedThrough":{"type":"string","format":"date"},"lawVerifiedThrough":{"type":"string","format":"date"},"input":{"type":"object"},"result":{"type":"object"},"formula":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}}},"docs":{"type":"string"},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"hint":{"type":"string"},"docs":{"type":"string"}}}}}}}}},"/api/calculate/aww":{"get":{"summary":"Average weekly wage (plain average)","description":"Plain average of gross weekly wages. Note: Minnesota law recognizes several AWW methods; this endpoint computes the simple average. Minn. Stat. 176.011.","parameters":[{"name":"wages","in":"query","required":true,"description":"Comma-separated gross weekly wages","schema":{"type":"string"},"example":"1000,950,1100"}],"responses":{"200":{"description":"Calculation result with formula, sources, and rate metadata","content":{"application/json":{"schema":{"type":"object","properties":{"calculator":{"type":"string"},"version":{"type":"string"},"ratesVerifiedThrough":{"type":"string","format":"date"},"lawVerifiedThrough":{"type":"string","format":"date"},"input":{"type":"object"},"result":{"type":"object"},"formula":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}}},"docs":{"type":"string"},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"hint":{"type":"string"},"docs":{"type":"string"}}}}}}}}},"/api/calculate/ppd":{"get":{"summary":"Permanent partial disability (PPD) dollars","description":"Converts a whole-body PPD rating percentage into dollars using the schedule in effect on the date of injury. Minn. Stat. 176.101, subd. 2a; Minn. R. ch. 5223.","parameters":[{"name":"doi","in":"query","required":true,"description":"Date of injury (YYYY-MM-DD)","schema":{"type":"string"},"example":"2025-10-01"},{"name":"rating","in":"query","required":true,"description":"Whole-body rating percent (0-100)","schema":{"type":"string"},"example":"7"}],"responses":{"200":{"description":"Calculation result with formula, sources, and rate metadata","content":{"application/json":{"schema":{"type":"object","properties":{"calculator":{"type":"string"},"version":{"type":"string"},"ratesVerifiedThrough":{"type":"string","format":"date"},"lawVerifiedThrough":{"type":"string","format":"date"},"input":{"type":"object"},"result":{"type":"object"},"formula":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}}},"docs":{"type":"string"},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"hint":{"type":"string"},"docs":{"type":"string"}}}}}}}}},"/api/calculate/ptd":{"get":{"summary":"Permanent total disability (PTD) weekly rate","description":"Two-thirds of AWW with a floor of 65% of SAWW and the date-of-injury maximum, escalated under Minn. Stat. 176.645, with optional government-benefit offsets. Minn. Stat. 176.101, subd. 4.","parameters":[{"name":"doi","in":"query","required":true,"description":"Date of injury (YYYY-MM-DD)","schema":{"type":"string"},"example":"2020-06-01"},{"name":"aww","in":"query","required":true,"description":"Gross average weekly wage in dollars","schema":{"type":"string"},"example":"1500"},{"name":"asOf","in":"query","required":false,"description":"Rate as of this date (default: today)","schema":{"type":"string"},"example":"2026-07-01"},{"name":"govtMonthly","in":"query","required":false,"description":"Monthly government disability/retirement benefits for the offset, in dollars","schema":{"type":"string"}},{"name":"peraMonthly","in":"query","required":false,"description":"Monthly PERA/MSRS benefit for the offset, in dollars","schema":{"type":"string"}}],"responses":{"200":{"description":"Calculation result with formula, sources, and rate metadata","content":{"application/json":{"schema":{"type":"object","properties":{"calculator":{"type":"string"},"version":{"type":"string"},"ratesVerifiedThrough":{"type":"string","format":"date"},"lawVerifiedThrough":{"type":"string","format":"date"},"input":{"type":"object"},"result":{"type":"object"},"formula":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}}},"docs":{"type":"string"},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"hint":{"type":"string"},"docs":{"type":"string"}}}}}}}}},"/api/calculate/death-dependency":{"get":{"summary":"Death and dependency benefits","description":"Weekly dependency benefits by scenario, burial expense, and the no-dependent estate payment. Minn. Stat. 176.111.","parameters":[{"name":"dateOfDeath","in":"query","required":true,"description":"Date of death (YYYY-MM-DD)","schema":{"type":"string"},"example":"2025-11-01"},{"name":"weeklyWage","in":"query","required":true,"description":"Weekly wage at the time of injury, in dollars","schema":{"type":"string"},"example":"1200"},{"name":"scenario","in":"query","required":true,"description":"One of: spouse_only, spouse_with_children, orphans, parents, remote_dependents, none","schema":{"type":"string"},"example":"spouse_only"},{"name":"children","in":"query","required":false,"description":"Comma-separated child birth dates (YYYY-MM-DD), required for spouse_with_children and orphans","schema":{"type":"string"}},{"name":"parentsCount","in":"query","required":false,"description":"1 or 2, for the parents scenario","schema":{"type":"string"}},{"name":"dependentsCount","in":"query","required":false,"description":"Count for the remote_dependents scenario","schema":{"type":"string"}}],"responses":{"200":{"description":"Calculation result with formula, sources, and rate metadata","content":{"application/json":{"schema":{"type":"object","properties":{"calculator":{"type":"string"},"version":{"type":"string"},"ratesVerifiedThrough":{"type":"string","format":"date"},"lawVerifiedThrough":{"type":"string","format":"date"},"input":{"type":"object"},"result":{"type":"object"},"formula":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"url":{"type":"string"}}}},"docs":{"type":"string"},"disclaimer":{"type":"string"}}}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"hint":{"type":"string"},"docs":{"type":"string"}}}}}}}}}}}