{"openapi":"3.0.3","info":{"title":"Hanse German & EU Rules API","version":"0.2.0","description":"Paid deterministic German payroll and deadline planning services. Results are not tax or legal advice."},"servers":[{"url":"https://automaton.72.62.51.224.sslip.io"}],"paths":{"/brutto-netto":{"post":{"summary":"Estimate monthly net pay","operationId":"estimateGermanPayroll","tags":["payroll"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayrollInput"},"example":{"gross_monthly":3000,"tax_class":1,"children":0,"church_tax":false,"state":"BY","year":2026}}}},"responses":{"200":{"description":"Successful paid estimate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayrollResponse"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required; decode PAYMENT-REQUIRED and retry with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/deadline":{"post":{"summary":"Calculate a German calendar or business-day deadline","operationId":"calculateGermanDeadline","tags":["deadlines"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeadlineInput"},"example":{"start_date":"2026-09-18","days":5,"mode":"business","include_start":false,"state":"BY"}}}},"responses":{"200":{"description":"Successful paid deadline calculation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeadlineResponse"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required; decode PAYMENT-REQUIRED and retry with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 v2 payment requirements","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"DeadlineInput":{"type":"object","required":["start_date","days"],"properties":{"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"days":{"type":"integer","minimum":0,"maximum":3660},"mode":{"type":"string","enum":["calendar","business"],"default":"calendar"},"include_start":{"type":"boolean","default":false},"state":{"type":"string","enum":["BY","BW","SN"],"default":"BY"}}},"DeadlineResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","properties":{"start_date":{"type":"string"},"deadline_date":{"type":"string"},"days":{"type":"integer"},"mode":{"type":"string"},"state":{"type":"string"},"assumptions":{"type":"object"}}},"meta":{"type":"object","properties":{"service":{"type":"string"},"paid":{"type":"boolean"}}}}},"PayrollInput":{"type":"object","required":["gross_monthly"],"properties":{"gross_monthly":{"type":"number","minimum":0,"maximum":1000000},"tax_class":{"type":"integer","minimum":1,"maximum":6,"default":1},"children":{"type":"integer","minimum":0,"maximum":10,"default":0},"church_tax":{"type":"boolean","default":false},"state":{"type":"string","enum":["BY","BW","SN"],"default":"BY"},"year":{"type":"integer","minimum":2024,"maximum":2030,"default":2026}}},"PayrollResponse":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"type":"object"}}},"Error":{"type":"object","properties":{"error":{"type":"string"}}}}}}