{ "openapi": "3.1.0", "info": { "title": "rel.tax — Multi-Country B2B Tax Calculator", "version": "2.0.0", "description": "Calculate net income after taxes for self-employed, B2B, and contractor workers across 50+ countries. Input gross income and country code, get detailed tax breakdown including net income, effective tax rate, hourly rate, and working days. No authentication required.", "contact": { "url": "https://rel.tax" }, "license": { "name": "MIT" } }, "servers": [ { "url": "https://rel.tax", "description": "Production" } ], "paths": { "/v1/calculate/pl": { "get": { "operationId": "calculate_pl_get", "summary": "Calculate taxes for Poland", "description": "Polish B2B Tax Calculator (ZUS, health insurance, PIT)", "tags": [ "Poland" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross income in PLN" }, "description": "Gross income in PLN" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "monthly" } }, { "name": "taxationType", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "lumpsum", "linear", "scale" ], "default": "lumpsum" } }, { "name": "lumpSumRate", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 2, 3, 5.5, 8.5, 10, 12, 14, 15, 17 ], "default": 12 } }, { "name": "zusRate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "normal", "preferential", "start", "none" ], "default": "normal" } }, { "name": "sickInsurance", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Include chorobowe (2.45%)" }, "description": "Include chorobowe (2.45%)" }, { "name": "costs", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Monthly business costs PLN" }, "description": "Monthly business costs PLN" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 26, "description": "Vacation days/year" }, "description": "Vacation days/year" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "zusBase", "in": "query", "required": false, "schema": { "type": "number", "default": 60, "description": "ZUS base as % of avg salary" }, "description": "ZUS base as % of avg salary" }, { "name": "sickDays", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Days on sick leave" }, "description": "Days on sick leave" }, { "name": "vatPayer", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "description": "Include VAT calculation" }, "description": "Include VAT calculation" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_pl_post", "summary": "Calculate taxes for Poland (JSON body)", "description": "Polish B2B Tax Calculator (ZUS, health insurance, PIT)", "tags": [ "Poland" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross income in PLN" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "monthly" }, "taxationType": { "type": "string", "enum": [ "lumpsum", "linear", "scale" ], "default": "lumpsum" }, "lumpSumRate": { "type": "number", "enum": [ 2, 3, 5.5, 8.5, 10, 12, 14, 15, 17 ], "default": 12 }, "zusRate": { "type": "string", "enum": [ "normal", "preferential", "start", "none" ], "default": "normal" }, "sickInsurance": { "type": "boolean", "default": false, "description": "Include chorobowe (2.45%)" }, "costs": { "type": "number", "default": 0, "description": "Monthly business costs PLN" }, "paidDaysOff": { "type": "number", "default": 26, "description": "Vacation days/year" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "zusBase": { "type": "number", "default": 60, "description": "ZUS base as % of avg salary" }, "sickDays": { "type": "number", "default": 0, "description": "Days on sick leave" }, "vatPayer": { "type": "boolean", "default": true, "description": "Include VAT calculation" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/nz": { "get": { "operationId": "calculate_nz_get", "summary": "Calculate taxes for New Zealand", "description": "New Zealand PAYE, ACC, KiwiSaver Calculator", "tags": [ "New Zealand" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross income NZD" }, "description": "Gross income NZD" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "kiwiSaverRate", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 3, 4, 6, 8, 10 ], "default": 3 } }, { "name": "studentLoan", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Has student loan" }, "description": "Has student loan" }, { "name": "acc", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "description": "Include ACC earners' levy (1.67%)" }, "description": "Include ACC earners' levy (1.67%)" }, { "name": "gstRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "GST registered (15%)" }, "description": "GST registered (15%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_nz_post", "summary": "Calculate taxes for New Zealand (JSON body)", "description": "New Zealand PAYE, ACC, KiwiSaver Calculator", "tags": [ "New Zealand" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross income NZD" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "kiwiSaverRate": { "type": "number", "enum": [ 0, 3, 4, 6, 8, 10 ], "default": 3 }, "studentLoan": { "type": "boolean", "default": false, "description": "Has student loan" }, "acc": { "type": "boolean", "default": true, "description": "Include ACC earners' levy (1.67%)" }, "gstRegistered": { "type": "boolean", "default": false, "description": "GST registered (15%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/au": { "get": { "operationId": "calculate_au_get", "summary": "Calculate taxes for Australia", "description": "Australian Income Tax, Medicare, HELP/HECS Calculator", "tags": [ "Australia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Taxable income AUD" }, "description": "Taxable income AUD" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "helpDebt", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Has HELP/HECS student loan" }, "description": "Has HELP/HECS student loan" }, { "name": "medicareLevyExempt", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Full Medicare levy exemption" }, "description": "Full Medicare levy exemption" }, { "name": "privateHealth", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Has private hospital cover" }, "description": "Has private hospital cover" }, { "name": "superRate", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Self-funded super % (0 = employer default 12%)" }, "description": "Self-funded super % (0 = employer default 12%)" }, { "name": "gstRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "GST registered (10%)" }, "description": "GST registered (10%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_au_post", "summary": "Calculate taxes for Australia (JSON body)", "description": "Australian Income Tax, Medicare, HELP/HECS Calculator", "tags": [ "Australia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Taxable income AUD" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "helpDebt": { "type": "boolean", "default": false, "description": "Has HELP/HECS student loan" }, "medicareLevyExempt": { "type": "boolean", "default": false, "description": "Full Medicare levy exemption" }, "privateHealth": { "type": "boolean", "default": false, "description": "Has private hospital cover" }, "superRate": { "type": "number", "default": 0, "description": "Self-funded super % (0 = employer default 12%)" }, "gstRegistered": { "type": "boolean", "default": false, "description": "GST registered (10%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/gb": { "get": { "operationId": "calculate_gb_get", "summary": "Calculate taxes for United Kingdom", "description": "UK Self-Employed Income Tax, Class 4 NIC, Student Loan Calculator", "tags": [ "United Kingdom" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income GBP" }, "description": "Annual gross income GBP" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "region", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "england", "scotland" ], "default": "england" } }, { "name": "studentLoan", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "none", "plan1", "plan2", "plan4", "plan5", "postgrad" ], "default": "none" } }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (20%)" }, "description": "VAT registered (20%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 28, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_gb_post", "summary": "Calculate taxes for United Kingdom (JSON body)", "description": "UK Self-Employed Income Tax, Class 4 NIC, Student Loan Calculator", "tags": [ "United Kingdom" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income GBP" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "region": { "type": "string", "enum": [ "england", "scotland" ], "default": "england" }, "studentLoan": { "type": "string", "enum": [ "none", "plan1", "plan2", "plan4", "plan5", "postgrad" ], "default": "none" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (20%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 28, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/us": { "get": { "operationId": "calculate_us_get", "summary": "Calculate taxes for United States", "description": "US Federal Self-Employment Tax & Income Tax Calculator (Single Filer)", "tags": [ "United States" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Net self-employment income USD" }, "description": "Net self-employment income USD" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "filingStatus", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "single" ], "default": "single" } }, { "name": "qbiDeduction", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "description": "Apply QBI deduction (20%)" }, "description": "Apply QBI deduction (20%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_us_post", "summary": "Calculate taxes for United States (JSON body)", "description": "US Federal Self-Employment Tax & Income Tax Calculator (Single Filer)", "tags": [ "United States" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Net self-employment income USD" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "filingStatus": { "type": "string", "enum": [ "single" ], "default": "single" }, "qbiDeduction": { "type": "boolean", "default": true, "description": "Apply QBI deduction (20%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/ca": { "get": { "operationId": "calculate_ca_get", "summary": "Calculate taxes for Canada", "description": "Canadian Federal + Provincial Self-Employed Tax Calculator (CPP, EI, Income Tax)", "tags": [ "Canada" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Net self-employment income CAD" }, "description": "Net self-employment income CAD" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "province", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "ON", "BC", "AB", "QC", "MB", "SK", "NS", "NB", "PE", "NL", "YT", "NT", "NU" ], "default": "ON" } }, { "name": "eiOptIn", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Opted into EI (maternity/compassionate only)" }, "description": "Opted into EI (maternity/compassionate only)" }, { "name": "gstRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "GST/HST registered" }, "description": "GST/HST registered" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_ca_post", "summary": "Calculate taxes for Canada (JSON body)", "description": "Canadian Federal + Provincial Self-Employed Tax Calculator (CPP, EI, Income Tax)", "tags": [ "Canada" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Net self-employment income CAD" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "province": { "type": "string", "enum": [ "ON", "BC", "AB", "QC", "MB", "SK", "NS", "NB", "PE", "NL", "YT", "NT", "NU" ], "default": "ON" }, "eiOptIn": { "type": "boolean", "default": false, "description": "Opted into EI (maternity/compassionate only)" }, "gstRegistered": { "type": "boolean", "default": false, "description": "GST/HST registered" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/de": { "get": { "operationId": "calculate_de_get", "summary": "Calculate taxes for Germany", "description": "German Income Tax (Einkommensteuer), Solidarity Surcharge, Church Tax, Social Insurance Calculator", "tags": [ "Germany" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income EUR" }, "description": "Annual gross income EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "churchTax", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "none", "8", "9" ], "default": "none", "description": "Church tax rate: 8% (BW/BY) or 9% (other states)" }, "description": "Church tax rate: 8% (BW/BY) or 9% (other states)" }, { "name": "hasChildren", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "description": "Has children (affects Pflegeversicherung rate)" }, "description": "Has children (affects Pflegeversicherung rate)" }, { "name": "healthInsurance", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "statutory", "none" ], "default": "statutory", "description": "Health insurance type" }, "description": "Health insurance type" }, { "name": "zusatzbeitrag", "in": "query", "required": false, "schema": { "type": "number", "default": 2.5, "description": "GKV supplementary rate %" }, "description": "GKV supplementary rate %" }, { "name": "pensionInsurance", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Voluntary pension insurance" }, "description": "Voluntary pension insurance" }, { "name": "gewerbesteuer", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Subject to trade tax (Gewerbetreibende)" }, "description": "Subject to trade tax (Gewerbetreibende)" }, { "name": "hebesatz", "in": "query", "required": false, "schema": { "type": "number", "default": 400, "description": "Municipal trade tax multiplier %" }, "description": "Municipal trade tax multiplier %" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (19%)" }, "description": "VAT registered (19%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 30, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_de_post", "summary": "Calculate taxes for Germany (JSON body)", "description": "German Income Tax (Einkommensteuer), Solidarity Surcharge, Church Tax, Social Insurance Calculator", "tags": [ "Germany" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "churchTax": { "type": "string", "enum": [ "none", "8", "9" ], "default": "none", "description": "Church tax rate: 8% (BW/BY) or 9% (other states)" }, "hasChildren": { "type": "boolean", "default": true, "description": "Has children (affects Pflegeversicherung rate)" }, "healthInsurance": { "type": "string", "enum": [ "statutory", "none" ], "default": "statutory", "description": "Health insurance type" }, "zusatzbeitrag": { "type": "number", "default": 2.5, "description": "GKV supplementary rate %" }, "pensionInsurance": { "type": "boolean", "default": false, "description": "Voluntary pension insurance" }, "gewerbesteuer": { "type": "boolean", "default": false, "description": "Subject to trade tax (Gewerbetreibende)" }, "hebesatz": { "type": "number", "default": 400, "description": "Municipal trade tax multiplier %" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (19%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 30, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/es": { "get": { "operationId": "calculate_es_get", "summary": "Calculate taxes for Spain", "description": "Spanish IRPF (Income Tax), Autonomo Social Security (RETA) Calculator", "tags": [ "Spain" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income EUR" }, "description": "Annual gross income EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible business expenses EUR" }, "description": "Annual deductible business expenses EUR" }, { "name": "newAutonomo", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "New autonomo (tarifa plana SS + 20% IRPF reduction)" }, "description": "New autonomo (tarifa plana SS + 20% IRPF reduction)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "IVA registered (21%)" }, "description": "IVA registered (21%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 22, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_es_post", "summary": "Calculate taxes for Spain (JSON body)", "description": "Spanish IRPF (Income Tax), Autonomo Social Security (RETA) Calculator", "tags": [ "Spain" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible business expenses EUR" }, "newAutonomo": { "type": "boolean", "default": false, "description": "New autonomo (tarifa plana SS + 20% IRPF reduction)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "IVA registered (21%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 22, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/rs": { "get": { "operationId": "calculate_rs_get", "summary": "Calculate taxes for Serbia", "description": "Serbian self-employed tax calculator: Preduzetnik (lična zarada) and Paušalac (lump-sum)", "tags": [ "Serbia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income" }, "description": "Annual gross income" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "EUR", "RSD" ], "default": "EUR", "description": "Input/output currency" }, "description": "Input/output currency" }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses (preduzetnik only)" }, "description": "Annual deductible expenses (preduzetnik only)" }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "preduzetnik", "pausalac" ], "default": "preduzetnik", "description": "Tax model" }, "description": "Tax model" }, { "name": "pausalnaOsnovica", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Monthly lump-sum base in RSD (required for pausalac)" }, "description": "Monthly lump-sum base in RSD (required for pausalac)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "PDV registered (20%)" }, "description": "PDV registered (20%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_rs_post", "summary": "Calculate taxes for Serbia (JSON body)", "description": "Serbian self-employed tax calculator: Preduzetnik (lična zarada) and Paušalac (lump-sum)", "tags": [ "Serbia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "currency": { "type": "string", "enum": [ "EUR", "RSD" ], "default": "EUR", "description": "Input/output currency" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses (preduzetnik only)" }, "taxModel": { "type": "string", "enum": [ "preduzetnik", "pausalac" ], "default": "preduzetnik", "description": "Tax model" }, "pausalnaOsnovica": { "type": "number", "default": 0, "description": "Monthly lump-sum base in RSD (required for pausalac)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "PDV registered (20%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/jp": { "get": { "operationId": "calculate_jp_get", "summary": "Calculate taxes for Japan", "description": "Japan Self-Employed Tax Calculator (Income Tax, Resident Tax, Business Tax, NHI, National Pension)", "tags": [ "Japan" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross business income JPY" }, "description": "Annual gross business income JPY" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible business expenses JPY" }, "description": "Annual deductible business expenses JPY" }, { "name": "blueReturn", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "full", "paper", "basic", "none" ], "default": "full", "description": "Blue return deduction tier" }, "description": "Blue return deduction tier" }, { "name": "businessTaxRate", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 3, 4, 5 ], "default": 5, "description": "Business tax rate %" }, "description": "Business tax rate %" }, { "name": "nhiRate", "in": "query", "required": false, "schema": { "type": "number", "default": 10, "description": "NHI income-based rate % (varies by municipality)" }, "description": "NHI income-based rate % (varies by municipality)" }, { "name": "consumptionTax", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Consumption tax registered (10%)" }, "description": "Consumption tax registered (10%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 15, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_jp_post", "summary": "Calculate taxes for Japan (JSON body)", "description": "Japan Self-Employed Tax Calculator (Income Tax, Resident Tax, Business Tax, NHI, National Pension)", "tags": [ "Japan" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross business income JPY" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible business expenses JPY" }, "blueReturn": { "type": "string", "enum": [ "full", "paper", "basic", "none" ], "default": "full", "description": "Blue return deduction tier" }, "businessTaxRate": { "type": "number", "enum": [ 3, 4, 5 ], "default": 5, "description": "Business tax rate %" }, "nhiRate": { "type": "number", "default": 10, "description": "NHI income-based rate % (varies by municipality)" }, "consumptionTax": { "type": "boolean", "default": false, "description": "Consumption tax registered (10%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 15, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/ee": { "get": { "operationId": "calculate_ee_get", "summary": "Calculate taxes for Estonia", "description": "Estonian FIE: Income Tax, Social Tax, II Pillar Pension", "tags": [ "Estonia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income EUR" }, "description": "Gross business income EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "pensionPillarRate", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 0, 2, 4, 6 ], "default": 2 } }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (22%)" }, "description": "VAT registered (22%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_ee_post", "summary": "Calculate taxes for Estonia (JSON body)", "description": "Estonian FIE: Income Tax, Social Tax, II Pillar Pension", "tags": [ "Estonia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "pensionPillarRate": { "type": "number", "enum": [ 0, 2, 4, 6 ], "default": 2 }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (22%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/ge": { "get": { "operationId": "calculate_ge_get", "summary": "Calculate taxes for Georgia", "description": "Georgian Tax: SBS Turnover Tax or Regular Income Tax, Mandatory Pension", "tags": [ "Georgia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income GEL" }, "description": "Gross business income GEL" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxRegime", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "sbs", "regular" ], "default": "sbs", "description": "Small Business Status or regular" }, "description": "Small Business Status or regular" }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Business expenses GEL (regular regime only)" }, "description": "Business expenses GEL (regular regime only)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (18%)" }, "description": "VAT registered (18%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_ge_post", "summary": "Calculate taxes for Georgia (JSON body)", "description": "Georgian Tax: SBS Turnover Tax or Regular Income Tax, Mandatory Pension", "tags": [ "Georgia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income GEL" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxRegime": { "type": "string", "enum": [ "sbs", "regular" ], "default": "sbs", "description": "Small Business Status or regular" }, "expenses": { "type": "number", "default": 0, "description": "Business expenses GEL (regular regime only)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (18%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/am": { "get": { "operationId": "calculate_am_get", "summary": "Calculate taxes for Armenia", "description": "Armenian Tax: Turnover Tax (IT 1%, General 10%), Regular Income Tax 20%, Social Payments", "tags": [ "Armenia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income AMD" }, "description": "Gross business income AMD" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "currency", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "AMD", "USD" ], "default": "AMD", "description": "Currency label (no conversion)" }, "description": "Currency label (no conversion)" }, { "name": "taxRegime", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "turnover_it", "turnover_general", "regular" ], "default": "turnover_it" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Deductible expenses (regular regime only)" }, "description": "Deductible expenses (regular regime only)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (20%)" }, "description": "VAT registered (20%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_am_post", "summary": "Calculate taxes for Armenia (JSON body)", "description": "Armenian Tax: Turnover Tax (IT 1%, General 10%), Regular Income Tax 20%, Social Payments", "tags": [ "Armenia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income AMD" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "currency": { "type": "string", "enum": [ "AMD", "USD" ], "default": "AMD", "description": "Currency label (no conversion)" }, "taxRegime": { "type": "string", "enum": [ "turnover_it", "turnover_general", "regular" ], "default": "turnover_it" }, "expenses": { "type": "number", "default": 0, "description": "Deductible expenses (regular regime only)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (20%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/mx": { "get": { "operationId": "calculate_mx_get", "summary": "Calculate taxes for Mexico", "description": "Mexican freelancer: RESICO or General ISR, optional IMSS, IVA", "tags": [ "Mexico" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income MXN" }, "description": "Gross business income MXN" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxRegime", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "resico", "general" ], "default": "resico" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Deductible expenses (general regime only)" }, "description": "Deductible expenses (general regime only)" }, { "name": "imssOptIn", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Voluntary IMSS social security" }, "description": "Voluntary IMSS social security" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "description": "IVA registered (16%)" }, "description": "IVA registered (16%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 15, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_mx_post", "summary": "Calculate taxes for Mexico (JSON body)", "description": "Mexican freelancer: RESICO or General ISR, optional IMSS, IVA", "tags": [ "Mexico" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income MXN" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxRegime": { "type": "string", "enum": [ "resico", "general" ], "default": "resico" }, "expenses": { "type": "number", "default": 0, "description": "Deductible expenses (general regime only)" }, "imssOptIn": { "type": "boolean", "default": false, "description": "Voluntary IMSS social security" }, "vatRegistered": { "type": "boolean", "default": true, "description": "IVA registered (16%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 15, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/pt": { "get": { "operationId": "calculate_pt_get", "summary": "Calculate taxes for Portugal", "description": "Portuguese Freelancer: IRS, Solidarity Surcharge, Social Security (Seguranca Social)", "tags": [ "Portugal" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income EUR" }, "description": "Gross business income EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "activityType", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "services_listed", "services_other", "sales" ], "default": "services_listed" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Business expenses (organized regime only)" }, "description": "Business expenses (organized regime only)" }, { "name": "accountingRegime", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "simplified", "organized" ], "default": "simplified" } }, { "name": "newFreelancer", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "First 12 months: SS exempt" }, "description": "First 12 months: SS exempt" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "IVA registered (23%)" }, "description": "IVA registered (23%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 22, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_pt_post", "summary": "Calculate taxes for Portugal (JSON body)", "description": "Portuguese Freelancer: IRS, Solidarity Surcharge, Social Security (Seguranca Social)", "tags": [ "Portugal" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "activityType": { "type": "string", "enum": [ "services_listed", "services_other", "sales" ], "default": "services_listed" }, "expenses": { "type": "number", "default": 0, "description": "Business expenses (organized regime only)" }, "accountingRegime": { "type": "string", "enum": [ "simplified", "organized" ], "default": "simplified" }, "newFreelancer": { "type": "boolean", "default": false, "description": "First 12 months: SS exempt" }, "vatRegistered": { "type": "boolean", "default": false, "description": "IVA registered (23%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 22, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/nl": { "get": { "operationId": "calculate_nl_get", "summary": "Calculate taxes for Netherlands", "description": "Dutch ZZP: Box 1 Income Tax, Zelfstandigenaftrek, MKB-vrijstelling, ZVW", "tags": [ "Netherlands" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business profit EUR" }, "description": "Gross business profit EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "starter", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "First 3 of 5 years as entrepreneur" }, "description": "First 3 of 5 years as entrepreneur" }, { "name": "hoursExempt", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "True if NOT meeting 1225 hours criterion" }, "description": "True if NOT meeting 1225 hours criterion" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "description": "BTW registered (21%)" }, "description": "BTW registered (21%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 25, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_nl_post", "summary": "Calculate taxes for Netherlands (JSON body)", "description": "Dutch ZZP: Box 1 Income Tax, Zelfstandigenaftrek, MKB-vrijstelling, ZVW", "tags": [ "Netherlands" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business profit EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "starter": { "type": "boolean", "default": false, "description": "First 3 of 5 years as entrepreneur" }, "hoursExempt": { "type": "boolean", "default": false, "description": "True if NOT meeting 1225 hours criterion" }, "vatRegistered": { "type": "boolean", "default": true, "description": "BTW registered (21%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 25, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/bg": { "get": { "operationId": "calculate_bg_get", "summary": "Calculate taxes for Bulgaria", "description": "Bulgarian freelancer/sole trader: Income Tax, Social Insurance, Health Insurance (NZOK)", "tags": [ "Bulgaria" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income BGN" }, "description": "Gross business income BGN" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "activityType", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "freelancer", "sole_trader" ], "default": "freelancer" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Business expenses BGN (sole_trader only)" }, "description": "Business expenses BGN (sole_trader only)" }, { "name": "includeOzm", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Include illness & maternity (3.5%)" }, "description": "Include illness & maternity (3.5%)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (20%)" }, "description": "VAT registered (20%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_bg_post", "summary": "Calculate taxes for Bulgaria (JSON body)", "description": "Bulgarian freelancer/sole trader: Income Tax, Social Insurance, Health Insurance (NZOK)", "tags": [ "Bulgaria" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income BGN" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "activityType": { "type": "string", "enum": [ "freelancer", "sole_trader" ], "default": "freelancer" }, "expenses": { "type": "number", "default": 0, "description": "Business expenses BGN (sole_trader only)" }, "includeOzm": { "type": "boolean", "default": false, "description": "Include illness & maternity (3.5%)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (20%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/cz": { "get": { "operationId": "calculate_cz_get", "summary": "Calculate taxes for Czech Republic", "description": "Czech OSVČ: Income Tax (15%/23%), Social Insurance, Health Insurance, Flat-Rate Expenses", "tags": [ "Czech Republic" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income CZK" }, "description": "Gross business income CZK" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenseMethod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "flat_80", "flat_60", "flat_40", "flat_30", "actual" ], "default": "flat_60", "description": "80% craft, 60% trades (default), 40% professionals, 30% rental, or actual" }, "description": "80% craft, 60% trades (default), 40% professionals, 30% rental, or actual" }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Actual business expenses CZK (expenseMethod=actual only)" }, "description": "Actual business expenses CZK (expenseMethod=actual only)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "DPH registered (21%)" }, "description": "DPH registered (21%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 25, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_cz_post", "summary": "Calculate taxes for Czech Republic (JSON body)", "description": "Czech OSVČ: Income Tax (15%/23%), Social Insurance, Health Insurance, Flat-Rate Expenses", "tags": [ "Czech Republic" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income CZK" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenseMethod": { "type": "string", "enum": [ "flat_80", "flat_60", "flat_40", "flat_30", "actual" ], "default": "flat_60", "description": "80% craft, 60% trades (default), 40% professionals, 30% rental, or actual" }, "expenses": { "type": "number", "default": 0, "description": "Actual business expenses CZK (expenseMethod=actual only)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "DPH registered (21%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 25, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/ro": { "get": { "operationId": "calculate_ro_get", "summary": "Calculate taxes for Romania", "description": "Romanian B2B tax calculator: PFA (freelancer, real income) and SRL Micro-Enterprise (1%/3% turnover tax + salary + dividends)", "tags": [ "Romania" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue RON" }, "description": "Annual gross revenue RON" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "entityType", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "pfa", "srl_micro" ], "default": "pfa", "description": "PFA (freelancer) or SRL Micro-Enterprise" }, "description": "PFA (freelancer) or SRL Micro-Enterprise" }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual business expenses RON (PFA only)" }, "description": "Annual business expenses RON (PFA only)" }, { "name": "microRate", "in": "query", "required": false, "schema": { "type": "number", "enum": [ 1, 3 ], "default": 1, "description": "Micro tax %: 1 (with employee) or 3 (without)" }, "description": "Micro tax %: 1 (with employee) or 3 (without)" }, { "name": "optInCas", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Opt into CAS pension when below threshold (PFA only)" }, "description": "Opt into CAS pension when below threshold (PFA only)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "TVA registered (19%)" }, "description": "TVA registered (19%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 21, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_ro_post", "summary": "Calculate taxes for Romania (JSON body)", "description": "Romanian B2B tax calculator: PFA (freelancer, real income) and SRL Micro-Enterprise (1%/3% turnover tax + salary + dividends)", "tags": [ "Romania" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue RON" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "entityType": { "type": "string", "enum": [ "pfa", "srl_micro" ], "default": "pfa", "description": "PFA (freelancer) or SRL Micro-Enterprise" }, "expenses": { "type": "number", "default": 0, "description": "Annual business expenses RON (PFA only)" }, "microRate": { "type": "number", "enum": [ 1, 3 ], "default": 1, "description": "Micro tax %: 1 (with employee) or 3 (without)" }, "optInCas": { "type": "boolean", "default": false, "description": "Opt into CAS pension when below threshold (PFA only)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "TVA registered (19%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 21, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/ae": { "get": { "operationId": "calculate_ae_get", "summary": "Calculate taxes for United Arab Emirates", "description": "UAE B2B tax calculator: 0% personal income tax for freelancers, 9% corporate tax above AED 375,000 for free zone entities", "tags": [ "United Arab Emirates" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue AED" }, "description": "Annual gross revenue AED" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "entityType", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "freelancer", "freezone" ], "default": "freelancer", "description": "Freelancer (0% tax) or Free Zone entity (9% corp tax)" }, "description": "Freelancer (0% tax) or Free Zone entity (9% corp tax)" }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual business expenses AED (freezone only)" }, "description": "Annual business expenses AED (freezone only)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (5%)" }, "description": "VAT registered (5%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 30, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_ae_post", "summary": "Calculate taxes for United Arab Emirates (JSON body)", "description": "UAE B2B tax calculator: 0% personal income tax for freelancers, 9% corporate tax above AED 375,000 for free zone entities", "tags": [ "United Arab Emirates" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue AED" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "entityType": { "type": "string", "enum": [ "freelancer", "freezone" ], "default": "freelancer", "description": "Freelancer (0% tax) or Free Zone entity (9% corp tax)" }, "expenses": { "type": "number", "default": 0, "description": "Annual business expenses AED (freezone only)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (5%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 30, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/me": { "get": { "operationId": "calculate_me_get", "summary": "Calculate taxes for Montenegro", "description": "Montenegrin self-employed tax calculator: Preduzetnik (entrepreneur) with progressive income tax", "tags": [ "Montenegro" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in EUR" }, "description": "Annual gross income in EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "description": "Annual deductible expenses" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "PDV registered (21%)" }, "description": "PDV registered (21%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_me_post", "summary": "Calculate taxes for Montenegro (JSON body)", "description": "Montenegrin self-employed tax calculator: Preduzetnik (entrepreneur) with progressive income tax", "tags": [ "Montenegro" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "vatRegistered": { "type": "boolean", "default": false, "description": "PDV registered (21%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/cy": { "get": { "operationId": "calculate_cy_get", "summary": "Calculate taxes for Cyprus", "description": "Cyprus self-employed tax calculator: progressive income tax, social insurance, and GESY (GHS) health contributions", "tags": [ "Cyprus" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in EUR" }, "description": "Annual gross income in EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "description": "Annual deductible expenses" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (19%)" }, "description": "VAT registered (19%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_cy_post", "summary": "Calculate taxes for Cyprus (JSON body)", "description": "Cyprus self-employed tax calculator: progressive income tax, social insurance, and GESY (GHS) health contributions", "tags": [ "Cyprus" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (19%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/sg": { "get": { "operationId": "calculate_sg_get", "summary": "Calculate taxes for Singapore", "description": "Singapore self-employed tax calculator: progressive income tax and MediSave contributions", "tags": [ "Singapore" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in SGD" }, "description": "Annual gross income in SGD" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "description": "Annual deductible expenses" }, { "name": "ageGroup", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "below35", "age35to44", "age45to49", "age50plus" ], "default": "below35", "description": "Age group for MediSave rate" }, "description": "Age group for MediSave rate" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "GST registered (9%)" }, "description": "GST registered (9%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 14, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_sg_post", "summary": "Calculate taxes for Singapore (JSON body)", "description": "Singapore self-employed tax calculator: progressive income tax and MediSave contributions", "tags": [ "Singapore" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in SGD" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "ageGroup": { "type": "string", "enum": [ "below35", "age35to44", "age45to49", "age50plus" ], "default": "below35", "description": "Age group for MediSave rate" }, "vatRegistered": { "type": "boolean", "default": false, "description": "GST registered (9%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 14, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/hr": { "get": { "operationId": "calculate_hr_get", "summary": "Calculate taxes for Croatia", "description": "Croatian self-employed tax calculator: Obrt (real income) and Pausalni Obrt (flat-rate)", "tags": [ "Croatia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross income in EUR" }, "description": "Gross income in EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "obrt", "pausalni" ], "default": "obrt", "description": "Tax model" }, "description": "Tax model" }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses (obrt only)" }, "description": "Annual deductible expenses (obrt only)" }, { "name": "surtax", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "zagreb", "split", "rijeka", "osijek", "none" ], "default": "zagreb", "description": "City surtax (prirez)" }, "description": "City surtax (prirez)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "PDV registered (25%)" }, "description": "PDV registered (25%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_hr_post", "summary": "Calculate taxes for Croatia (JSON body)", "description": "Croatian self-employed tax calculator: Obrt (real income) and Pausalni Obrt (flat-rate)", "tags": [ "Croatia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross income in EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxModel": { "type": "string", "enum": [ "obrt", "pausalni" ], "default": "obrt", "description": "Tax model" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses (obrt only)" }, "surtax": { "type": "string", "enum": [ "zagreb", "split", "rijeka", "osijek", "none" ], "default": "zagreb", "description": "City surtax (prirez)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "PDV registered (25%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/hu": { "get": { "operationId": "calculate_hu_get", "summary": "Calculate taxes for Hungary", "description": "Hungarian self-employed tax calculator: KATA (fixed tax) and EV (individual entrepreneur)", "tags": [ "Hungary" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in HUF" }, "description": "Annual gross income in HUF" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "kata", "ev" ], "default": "kata", "description": "Tax regime" }, "description": "Tax regime" }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses (EV only)" }, "description": "Annual deductible expenses (EV only)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (27%)" }, "description": "VAT registered (27%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_hu_post", "summary": "Calculate taxes for Hungary (JSON body)", "description": "Hungarian self-employed tax calculator: KATA (fixed tax) and EV (individual entrepreneur)", "tags": [ "Hungary" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in HUF" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxModel": { "type": "string", "enum": [ "kata", "ev" ], "default": "kata", "description": "Tax regime" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses (EV only)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (27%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/th": { "get": { "operationId": "calculate_th_get", "summary": "Calculate taxes for Thailand", "description": "Thai self-employed tax calculator: 8-bracket progressive income tax with expense deduction and personal allowance", "tags": [ "Thailand" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in THB" }, "description": "Annual gross income in THB" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (7%)" }, "description": "VAT registered (7%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 6, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_th_post", "summary": "Calculate taxes for Thailand (JSON body)", "description": "Thai self-employed tax calculator: 8-bracket progressive income tax with expense deduction and personal allowance", "tags": [ "Thailand" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in THB" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (7%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 6, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/my": { "get": { "operationId": "calculate_my_get", "summary": "Calculate taxes for Malaysia", "description": "Malaysian self-employed tax calculator: 10-bracket progressive income tax with personal relief", "tags": [ "Malaysia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in MYR" }, "description": "Annual gross income in MYR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "SST registered (8%)" }, "description": "SST registered (8%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 11, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_my_post", "summary": "Calculate taxes for Malaysia (JSON body)", "description": "Malaysian self-employed tax calculator: 10-bracket progressive income tax with personal relief", "tags": [ "Malaysia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in MYR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "vatRegistered": { "type": "boolean", "default": false, "description": "SST registered (8%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 11, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/cr": { "get": { "operationId": "calculate_cr_get", "summary": "Calculate taxes for Costa Rica", "description": "Costa Rican self-employed tax calculator: 5-bracket progressive income tax with CCSS social security", "tags": [ "Costa Rica" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in CRC" }, "description": "Annual gross income in CRC" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "description": "Annual deductible expenses" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "IVA registered (13%)" }, "description": "IVA registered (13%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 15, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_cr_post", "summary": "Calculate taxes for Costa Rica (JSON body)", "description": "Costa Rican self-employed tax calculator: 5-bracket progressive income tax with CCSS social security", "tags": [ "Costa Rica" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in CRC" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "vatRegistered": { "type": "boolean", "default": false, "description": "IVA registered (13%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 15, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/id": { "get": { "operationId": "calculate_id_get", "summary": "Calculate taxes for Indonesia", "description": "Indonesian self-employed tax calculator: UMKM simplified (0.5% final) or progressive income tax", "tags": [ "Indonesia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in IDR" }, "description": "Annual gross income in IDR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "umkm", "progressive" ], "default": "umkm", "description": "Tax regime" }, "description": "Tax regime" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "PPN registered (12%)" }, "description": "PPN registered (12%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 12, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_id_post", "summary": "Calculate taxes for Indonesia (JSON body)", "description": "Indonesian self-employed tax calculator: UMKM simplified (0.5% final) or progressive income tax", "tags": [ "Indonesia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in IDR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxModel": { "type": "string", "enum": [ "umkm", "progressive" ], "default": "umkm", "description": "Tax regime" }, "vatRegistered": { "type": "boolean", "default": false, "description": "PPN registered (12%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 12, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/co": { "get": { "operationId": "calculate_co_get", "summary": "Calculate taxes for Colombia", "description": "Colombian self-employed tax calculator: UVT-based progressive income tax with social contributions on IBC", "tags": [ "Colombia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in COP" }, "description": "Annual gross income in COP" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "description": "Annual deductible expenses" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "IVA registered (19%)" }, "description": "IVA registered (19%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 15, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_co_post", "summary": "Calculate taxes for Colombia (JSON body)", "description": "Colombian self-employed tax calculator: UVT-based progressive income tax with social contributions on IBC", "tags": [ "Colombia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in COP" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "vatRegistered": { "type": "boolean", "default": false, "description": "IVA registered (19%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 15, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/be": { "get": { "operationId": "calculate_be_get", "summary": "Calculate taxes for Belgium", "description": "Belgian self-employed tax calculator: 4-bracket progressive income tax with tiered social contributions and tax-free allowance", "tags": [ "Belgium" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in EUR" }, "description": "Annual gross income in EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "description": "Annual deductible expenses" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "BTW registered (21%)" }, "description": "BTW registered (21%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_be_post", "summary": "Calculate taxes for Belgium (JSON body)", "description": "Belgian self-employed tax calculator: 4-bracket progressive income tax with tiered social contributions and tax-free allowance", "tags": [ "Belgium" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "vatRegistered": { "type": "boolean", "default": false, "description": "BTW registered (21%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/fr": { "get": { "operationId": "calculate_fr_get", "summary": "Calculate taxes for France", "description": "French micro-entrepreneur tax calculator: Micro-BNC (progressive) or Versement Libératoire (flat)", "tags": [ "France" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual turnover in EUR" }, "description": "Annual turnover in EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "micro_bnc", "versement_liberatoire" ], "default": "micro_bnc", "description": "Tax regime" }, "description": "Tax regime" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "TVA registered (20%)" }, "description": "TVA registered (20%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 25, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_fr_post", "summary": "Calculate taxes for France (JSON body)", "description": "French micro-entrepreneur tax calculator: Micro-BNC (progressive) or Versement Libératoire (flat)", "tags": [ "France" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual turnover in EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxModel": { "type": "string", "enum": [ "micro_bnc", "versement_liberatoire" ], "default": "micro_bnc", "description": "Tax regime" }, "vatRegistered": { "type": "boolean", "default": false, "description": "TVA registered (20%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 25, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/ph": { "get": { "operationId": "calculate_ph_get", "summary": "Calculate taxes for Philippines", "description": "Philippines B2B freelancer tax calculator: 8% flat rate (below PHP 3M) or graduated progressive tax with 3% percentage tax", "tags": [ "Philippines" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue in PHP" }, "description": "Annual gross revenue in PHP" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "flat_8", "graduated" ], "default": "flat_8", "description": "8% flat rate (max PHP 3M/yr) or graduated progressive" }, "description": "8% flat rate (max PHP 3M/yr) or graduated progressive" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (12%)" }, "description": "VAT registered (12%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 5, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_ph_post", "summary": "Calculate taxes for Philippines (JSON body)", "description": "Philippines B2B freelancer tax calculator: 8% flat rate (below PHP 3M) or graduated progressive tax with 3% percentage tax", "tags": [ "Philippines" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue in PHP" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxModel": { "type": "string", "enum": [ "flat_8", "graduated" ], "default": "flat_8", "description": "8% flat rate (max PHP 3M/yr) or graduated progressive" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (12%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 5, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/it": { "get": { "operationId": "calculate_it_get", "summary": "Calculate taxes for Italy", "description": "Italian freelancer tax calculator: Forfettario (flat substitute tax 5%/15%) or Ordinario (progressive IRPEF)", "tags": [ "Italy" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue in EUR" }, "description": "Annual gross revenue in EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "forfettario", "ordinario" ], "default": "forfettario", "description": "Tax regime" }, "description": "Tax regime" }, { "name": "startup", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Startup rate (5% instead of 15%) for forfettario, first 5 years" }, "description": "Startup rate (5% instead of 15%) for forfettario, first 5 years" }, { "name": "profitabilityCoefficient", "in": "query", "required": false, "schema": { "type": "number", "default": 0.78, "description": "Profitability coefficient for forfettario (activity-specific)" }, "description": "Profitability coefficient for forfettario (activity-specific)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "IVA registered (22%)" }, "description": "IVA registered (22%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_it_post", "summary": "Calculate taxes for Italy (JSON body)", "description": "Italian freelancer tax calculator: Forfettario (flat substitute tax 5%/15%) or Ordinario (progressive IRPEF)", "tags": [ "Italy" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue in EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxModel": { "type": "string", "enum": [ "forfettario", "ordinario" ], "default": "forfettario", "description": "Tax regime" }, "startup": { "type": "boolean", "default": false, "description": "Startup rate (5% instead of 15%) for forfettario, first 5 years" }, "profitabilityCoefficient": { "type": "number", "default": 0.78, "description": "Profitability coefficient for forfettario (activity-specific)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "IVA registered (22%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/lt": { "get": { "operationId": "calculate_lt_get", "summary": "Calculate taxes for Lithuania", "description": "Lithuania self-employed individual activity (individuali veikla): progressive income tax 5/15/20%, Sodra social insurance (19.5% on 90% of profit, capped), and fixed PSD health insurance", "tags": [ "Lithuania" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue EUR" }, "description": "Annual gross revenue EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual business expenses EUR" }, "description": "Annual business expenses EUR" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (21%)" }, "description": "VAT registered (21%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_lt_post", "summary": "Calculate taxes for Lithuania (JSON body)", "description": "Lithuania self-employed individual activity (individuali veikla): progressive income tax 5/15/20%, Sodra social insurance (19.5% on 90% of profit, capped), and fixed PSD health insurance", "tags": [ "Lithuania" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual business expenses EUR" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (21%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/gr": { "get": { "operationId": "calculate_gr_get", "summary": "Calculate taxes for Greece", "description": "Greece self-employed tax calculator: progressive income tax (9%-44%), EFKA social insurance with reduced rate for new businesses, and optional special regime (50% exemption for relocators)", "tags": [ "Greece" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue EUR" }, "description": "Annual gross revenue EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual business expenses EUR (reduces taxable base)" }, "description": "Annual business expenses EUR (reduces taxable base)" }, { "name": "newBusiness", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "New business (first 5 years): reduced EFKA rate 146.75/month instead of 220.12/month" }, "description": "New business (first 5 years): reduced EFKA rate 146.75/month instead of 220.12/month" }, { "name": "specialRegime", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Special tax regime for relocators: 50% income exemption" }, "description": "Special tax regime for relocators: 50% income exemption" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (24%)" }, "description": "VAT registered (24%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_gr_post", "summary": "Calculate taxes for Greece (JSON body)", "description": "Greece self-employed tax calculator: progressive income tax (9%-44%), EFKA social insurance with reduced rate for new businesses, and optional special regime (50% exemption for relocators)", "tags": [ "Greece" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual business expenses EUR (reduces taxable base)" }, "newBusiness": { "type": "boolean", "default": false, "description": "New business (first 5 years): reduced EFKA rate 146.75/month instead of 220.12/month" }, "specialRegime": { "type": "boolean", "default": false, "description": "Special tax regime for relocators: 50% income exemption" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (24%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/ie": { "get": { "operationId": "calculate_ie_get", "summary": "Calculate taxes for Ireland", "description": "Ireland self-employed tax calculator: progressive income tax (20%/40%) with USC, PRSI, and tax credits", "tags": [ "Ireland" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue EUR" }, "description": "Annual gross revenue EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual business expenses EUR" }, "description": "Annual business expenses EUR" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (23%)" }, "description": "VAT registered (23%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_ie_post", "summary": "Calculate taxes for Ireland (JSON body)", "description": "Ireland self-employed tax calculator: progressive income tax (20%/40%) with USC, PRSI, and tax credits", "tags": [ "Ireland" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual business expenses EUR" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (23%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/at": { "get": { "operationId": "calculate_at_get", "summary": "Calculate taxes for Austria", "description": "Austria self-employed (Einzelunternehmer) tax calculator: progressive income tax up to 55%, SVS social insurance (26.83% + accident), Gewinnfreibetrag deduction up to 4,950 EUR", "tags": [ "Austria" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue EUR" }, "description": "Annual gross revenue EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual business expenses EUR" }, "description": "Annual business expenses EUR" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (20%)" }, "description": "VAT registered (20%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 25, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_at_post", "summary": "Calculate taxes for Austria (JSON body)", "description": "Austria self-employed (Einzelunternehmer) tax calculator: progressive income tax up to 55%, SVS social insurance (26.83% + accident), Gewinnfreibetrag deduction up to 4,950 EUR", "tags": [ "Austria" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual business expenses EUR" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (20%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 25, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/se": { "get": { "operationId": "calculate_se_get", "summary": "Calculate taxes for Sweden", "description": "Sweden Enskild Firma (sole trader) tax calculator: egenavgifter (28.97%), municipal income tax (~32.37%), state tax (20% above SEK 613,900)", "tags": [ "Sweden" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue SEK" }, "description": "Annual gross revenue SEK" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible business expenses SEK" }, "description": "Annual deductible business expenses SEK" }, { "name": "municipalRate", "in": "query", "required": false, "schema": { "type": "number", "default": 0.3237, "description": "Municipal tax rate (varies by municipality, national average 0.3237)" }, "description": "Municipal tax rate (varies by municipality, national average 0.3237)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (25%)" }, "description": "VAT registered (25%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 25, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_se_post", "summary": "Calculate taxes for Sweden (JSON body)", "description": "Sweden Enskild Firma (sole trader) tax calculator: egenavgifter (28.97%), municipal income tax (~32.37%), state tax (20% above SEK 613,900)", "tags": [ "Sweden" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue SEK" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible business expenses SEK" }, "municipalRate": { "type": "number", "default": 0.3237, "description": "Municipal tax rate (varies by municipality, national average 0.3237)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (25%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 25, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/il": { "get": { "operationId": "calculate_il_get", "summary": "Calculate taxes for Israel", "description": "Israel self-employed (עצמאי) tax calculator: progressive income tax with credit points, National Insurance (Bituach Leumi), and health tax", "tags": [ "Israel" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue ILS" }, "description": "Annual gross revenue ILS" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual business expenses ILS" }, "description": "Annual business expenses ILS" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (18%)" }, "description": "VAT registered (18%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 12, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_il_post", "summary": "Calculate taxes for Israel (JSON body)", "description": "Israel self-employed (עצמאי) tax calculator: progressive income tax with credit points, National Insurance (Bituach Leumi), and health tax", "tags": [ "Israel" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue ILS" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual business expenses ILS" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (18%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 12, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/in": { "get": { "operationId": "calculate_in_get", "summary": "Calculate taxes for India", "description": "India B2B freelancer tax calculator: presumptive taxation (44ADA, 50% deemed income), new regime (progressive with standard deduction + rebate), or old regime (legacy brackets). Health & education cess 4% applies.", "tags": [ "India" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross revenue INR" }, "description": "Annual gross revenue INR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "presumptive", "new_regime", "old_regime" ], "default": "presumptive", "description": "presumptive: 44ADA (50% deemed), new_regime: progressive with deduction, old_regime: legacy brackets" }, "description": "presumptive: 44ADA (50% deemed), new_regime: progressive with deduction, old_regime: legacy brackets" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "GST registered (18%)" }, "description": "GST registered (18%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 15, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_in_post", "summary": "Calculate taxes for India (JSON body)", "description": "India B2B freelancer tax calculator: presumptive taxation (44ADA, 50% deemed income), new regime (progressive with standard deduction + rebate), or old regime (legacy brackets). Health & education cess 4% applies.", "tags": [ "India" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross revenue INR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxModel": { "type": "string", "enum": [ "presumptive", "new_regime", "old_regime" ], "default": "presumptive", "description": "presumptive: 44ADA (50% deemed), new_regime: progressive with deduction, old_regime: legacy brackets" }, "vatRegistered": { "type": "boolean", "default": false, "description": "GST registered (18%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 15, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/dk": { "get": { "operationId": "calculate_dk_get", "summary": "Calculate taxes for Denmark", "description": "Danish self-employed (selvstændig) tax calculator with AM-bidrag, bundskat, kommuneskat, optional kirkeskat, topskat, and tax ceiling", "tags": [ "Denmark" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual income in DKK" }, "description": "Annual income in DKK" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "municipalRate", "in": "query", "required": false, "schema": { "type": "number", "default": 0.251, "description": "Municipal tax rate (national average 25.1%)" }, "description": "Municipal tax rate (national average 25.1%)" }, { "name": "churchTax", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Whether church tax applies" }, "description": "Whether church tax applies" }, { "name": "churchRate", "in": "query", "required": false, "schema": { "type": "number", "default": 0.007, "description": "Church tax rate (average 0.7%)" }, "description": "Church tax rate (average 0.7%)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (25% moms)" }, "description": "VAT registered (25% moms)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 25, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_dk_post", "summary": "Calculate taxes for Denmark (JSON body)", "description": "Danish self-employed (selvstændig) tax calculator with AM-bidrag, bundskat, kommuneskat, optional kirkeskat, topskat, and tax ceiling", "tags": [ "Denmark" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual income in DKK" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "municipalRate": { "type": "number", "default": 0.251, "description": "Municipal tax rate (national average 25.1%)" }, "churchTax": { "type": "boolean", "default": false, "description": "Whether church tax applies" }, "churchRate": { "type": "number", "default": 0.007, "description": "Church tax rate (average 0.7%)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (25% moms)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 25, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/fi": { "get": { "operationId": "calculate_fi_get", "summary": "Calculate taxes for Finland", "description": "Finnish self-employed tax calculator with YEL pension and progressive state+municipal tax", "tags": [ "Finland" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual income in EUR" }, "description": "Annual income in EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual business expenses in EUR" }, "description": "Annual business expenses in EUR" }, { "name": "municipalRate", "in": "query", "required": false, "schema": { "type": "number", "default": 0.0928, "description": "Municipal tax rate (national average 9.28%)" }, "description": "Municipal tax rate (national average 9.28%)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (25.5%)" }, "description": "VAT registered (25.5%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 25, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_fi_post", "summary": "Calculate taxes for Finland (JSON body)", "description": "Finnish self-employed tax calculator with YEL pension and progressive state+municipal tax", "tags": [ "Finland" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual income in EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual business expenses in EUR" }, "municipalRate": { "type": "number", "default": 0.0928, "description": "Municipal tax rate (national average 9.28%)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (25.5%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 25, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/no": { "get": { "operationId": "calculate_no_get", "summary": "Calculate taxes for Norway", "description": "Norwegian self-employed (Enkeltpersonforetak) tax calculator: Trinnskatt, ordinary tax, and trygdeavgift", "tags": [ "Norway" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross income NOK" }, "description": "Gross income NOK" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "description": "Annual deductible expenses" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "MVA registered (25%)" }, "description": "MVA registered (25%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 25, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_no_post", "summary": "Calculate taxes for Norway (JSON body)", "description": "Norwegian self-employed (Enkeltpersonforetak) tax calculator: Trinnskatt, ordinary tax, and trygdeavgift", "tags": [ "Norway" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross income NOK" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses" }, "vatRegistered": { "type": "boolean", "default": false, "description": "MVA registered (25%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 25, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/ch": { "get": { "operationId": "calculate_ch_get", "summary": "Calculate taxes for Switzerland", "description": "Swiss self-employed (Selbstständig) tax calculator with federal progressive tax, cantonal tax, and AHV/IV/EO social insurance", "tags": [ "Switzerland" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in CHF" }, "description": "Annual gross income in CHF" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible business expenses" }, "description": "Annual deductible business expenses" }, { "name": "cantonalRate", "in": "query", "required": false, "schema": { "type": "number", "default": 0.12, "description": "Effective cantonal/municipal tax rate (0-1). Default 0.12 approximates Zurich" }, "description": "Effective cantonal/municipal tax rate (0-1). Default 0.12 approximates Zurich" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "MWST registered (8.1%)" }, "description": "MWST registered (8.1%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 25, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_ch_post", "summary": "Calculate taxes for Switzerland (JSON body)", "description": "Swiss self-employed (Selbstständig) tax calculator with federal progressive tax, cantonal tax, and AHV/IV/EO social insurance", "tags": [ "Switzerland" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in CHF" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible business expenses" }, "cantonalRate": { "type": "number", "default": 0.12, "description": "Effective cantonal/municipal tax rate (0-1). Default 0.12 approximates Zurich" }, "vatRegistered": { "type": "boolean", "default": false, "description": "MWST registered (8.1%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 25, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/lv": { "get": { "operationId": "calculate_lv_get", "summary": "Calculate taxes for Latvia", "description": "Latvian self-employed tax calculator: Standard (progressive PIT + SSC) or Micro-enterprise (flat 25%)", "tags": [ "Latvia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual income in EUR" }, "description": "Annual income in EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "standard", "micro" ], "default": "standard", "description": "Tax regime" }, "description": "Tax regime" }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Business expenses (standard model only)" }, "description": "Business expenses (standard model only)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (21%)" }, "description": "VAT registered (21%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_lv_post", "summary": "Calculate taxes for Latvia (JSON body)", "description": "Latvian self-employed tax calculator: Standard (progressive PIT + SSC) or Micro-enterprise (flat 25%)", "tags": [ "Latvia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual income in EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxModel": { "type": "string", "enum": [ "standard", "micro" ], "default": "standard", "description": "Tax regime" }, "expenses": { "type": "number", "default": 0, "description": "Business expenses (standard model only)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (21%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/sk": { "get": { "operationId": "calculate_sk_get", "summary": "Calculate taxes for Slovakia", "description": "Slovak SZČO: Income Tax (15%/19%/25%), Social Insurance, Health Insurance, Flat-Rate Expenses", "tags": [ "Slovakia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income EUR" }, "description": "Gross business income EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "useFlatExpenses", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "description": "Use 60% flat expense deduction (max 20,000 EUR)" }, "description": "Use 60% flat expense deduction (max 20,000 EUR)" }, { "name": "actualExpenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Actual business expenses EUR (useFlatExpenses=false only)" }, "description": "Actual business expenses EUR (useFlatExpenses=false only)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "DPH registered (23%)" }, "description": "DPH registered (23%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_sk_post", "summary": "Calculate taxes for Slovakia (JSON body)", "description": "Slovak SZČO: Income Tax (15%/19%/25%), Social Insurance, Health Insurance, Flat-Rate Expenses", "tags": [ "Slovakia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "useFlatExpenses": { "type": "boolean", "default": true, "description": "Use 60% flat expense deduction (max 20,000 EUR)" }, "actualExpenses": { "type": "number", "default": 0, "description": "Actual business expenses EUR (useFlatExpenses=false only)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "DPH registered (23%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/si": { "get": { "operationId": "calculate_si_get", "summary": "Calculate taxes for Slovenia", "description": "Slovenian self-employed tax calculator: Normiranec (flat-rate 80% normative) and Standard (progressive)", "tags": [ "Slovenia" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Annual gross income in EUR" }, "description": "Annual gross income in EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxModel", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "normiranec", "standard" ], "default": "normiranec", "description": "Tax model" }, "description": "Tax model" }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible expenses (standard model only)" }, "description": "Annual deductible expenses (standard model only)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "DDV registered (22%)" }, "description": "DDV registered (22%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 20, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_si_post", "summary": "Calculate taxes for Slovenia (JSON body)", "description": "Slovenian self-employed tax calculator: Normiranec (flat-rate 80% normative) and Standard (progressive)", "tags": [ "Slovenia" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Annual gross income in EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxModel": { "type": "string", "enum": [ "normiranec", "standard" ], "default": "normiranec", "description": "Tax model" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible expenses (standard model only)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "DDV registered (22%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 20, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/mt": { "get": { "operationId": "calculate_mt_get", "summary": "Calculate taxes for Malta", "description": "Maltese self-employed tax calculator: Progressive income tax (single rates) and Class 2 SSC", "tags": [ "Malta" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income EUR" }, "description": "Gross business income EUR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible business expenses" }, "description": "Annual deductible business expenses" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (18%)" }, "description": "VAT registered (18%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 24, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_mt_post", "summary": "Calculate taxes for Malta (JSON body)", "description": "Maltese self-employed tax calculator: Progressive income tax (single rates) and Class 2 SSC", "tags": [ "Malta" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income EUR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible business expenses" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (18%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 24, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/tr": { "get": { "operationId": "calculate_tr_get", "summary": "Calculate taxes for Turkey", "description": "Turkish self-employed (serbest meslek) tax calculator with BAG-KUR social security", "tags": [ "Turkey" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross income in TRY" }, "description": "Gross income in TRY" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "expenses", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Annual deductible business expenses" }, "description": "Annual deductible business expenses" }, { "name": "bagkurBase", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "minimum", "actual", "maximum" ], "default": "minimum", "description": "BAG-KUR contribution base selection" }, "description": "BAG-KUR contribution base selection" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "KDV registered (20%)" }, "description": "KDV registered (20%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 14, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_tr_post", "summary": "Calculate taxes for Turkey (JSON body)", "description": "Turkish self-employed (serbest meslek) tax calculator with BAG-KUR social security", "tags": [ "Turkey" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross income in TRY" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "expenses": { "type": "number", "default": 0, "description": "Annual deductible business expenses" }, "bagkurBase": { "type": "string", "enum": [ "minimum", "actual", "maximum" ], "default": "minimum", "description": "BAG-KUR contribution base selection" }, "vatRegistered": { "type": "boolean", "default": false, "description": "KDV registered (20%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 14, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/ua": { "get": { "operationId": "calculate_ua_get", "summary": "Calculate taxes for Ukraine", "description": "Ukrainian ФОП (FOP): Unified Tax, Military Levy, ESV Social Contribution", "tags": [ "Ukraine" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income UAH" }, "description": "Gross business income UAH" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "fopGroup", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "group2", "group3" ], "default": "group3", "description": "FOP group (group3 = 5% flat, most common for IT)" }, "description": "FOP group (group3 = 5% flat, most common for IT)" }, { "name": "vatPayer", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT payer (20%). Group 3 with VAT pays 3% unified tax instead of 5%" }, "description": "VAT payer (20%). Group 3 with VAT pays 3% unified tax instead of 5%" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 24, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_ua_post", "summary": "Calculate taxes for Ukraine (JSON body)", "description": "Ukrainian ФОП (FOP): Unified Tax, Military Levy, ESV Social Contribution", "tags": [ "Ukraine" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income UAH" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "fopGroup": { "type": "string", "enum": [ "group2", "group3" ], "default": "group3", "description": "FOP group (group3 = 5% flat, most common for IT)" }, "vatPayer": { "type": "boolean", "default": false, "description": "VAT payer (20%). Group 3 with VAT pays 3% unified tax instead of 5%" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 24, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/br": { "get": { "operationId": "calculate_br_get", "summary": "Calculate taxes for Brazil", "description": "Brazilian Tax: MEI (fixed DAS), Simples Nacional (tiered), or Autônomo (progressive IRPF + INSS)", "tags": [ "Brazil" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross business income BRL" }, "description": "Gross business income BRL" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxRegime", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "mei", "simples", "autonomo" ], "default": "mei", "description": "MEI = fixed low tax (up to R$81k), Simples = tiered, Autônomo = progressive" }, "description": "MEI = fixed low tax (up to R$81k), Simples = tiered, Autônomo = progressive" }, { "name": "activityType", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "services", "commerce" ], "default": "services", "description": "Affects ISS/ICMS in MEI regime" }, "description": "Affects ISS/ICMS in MEI regime" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 30, "description": "Annual leave days (Brazil standard: 30)" }, "description": "Annual leave days (Brazil standard: 30)" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_br_post", "summary": "Calculate taxes for Brazil (JSON body)", "description": "Brazilian Tax: MEI (fixed DAS), Simples Nacional (tiered), or Autônomo (progressive IRPF + INSS)", "tags": [ "Brazil" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross business income BRL" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxRegime": { "type": "string", "enum": [ "mei", "simples", "autonomo" ], "default": "mei", "description": "MEI = fixed low tax (up to R$81k), Simples = tiered, Autônomo = progressive" }, "activityType": { "type": "string", "enum": [ "services", "commerce" ], "default": "services", "description": "Affects ISS/ICMS in MEI regime" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 30, "description": "Annual leave days (Brazil standard: 30)" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/vn": { "get": { "operationId": "calculate_vn_get", "summary": "Calculate taxes for Vietnam", "description": "Vietnamese PIT: Progressive brackets or simplified business tax, social/health/unemployment insurance", "tags": [ "Vietnam" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross income VND" }, "description": "Gross income VND" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "taxMethod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "progressive", "simplified" ], "default": "simplified", "description": "Progressive PIT (7 brackets 5-35%) or simplified business tax (5% services)" }, "description": "Progressive PIT (7 brackets 5-35%) or simplified business tax (5% services)" }, { "name": "dependents", "in": "query", "required": false, "schema": { "type": "number", "default": 0, "description": "Number of dependents (4.4M VND deduction each)" }, "description": "Number of dependents (4.4M VND deduction each)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (8%)" }, "description": "VAT registered (8%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 12, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_vn_post", "summary": "Calculate taxes for Vietnam (JSON body)", "description": "Vietnamese PIT: Progressive brackets or simplified business tax, social/health/unemployment insurance", "tags": [ "Vietnam" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross income VND" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "taxMethod": { "type": "string", "enum": [ "progressive", "simplified" ], "default": "simplified", "description": "Progressive PIT (7 brackets 5-35%) or simplified business tax (5% services)" }, "dependents": { "type": "number", "default": 0, "description": "Number of dependents (4.4M VND deduction each)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (8%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 12, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/za": { "get": { "operationId": "calculate_za_get", "summary": "Calculate taxes for South Africa", "description": "South African Tax: Progressive income tax with rebates, UIF", "tags": [ "South Africa" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross income ZAR" }, "description": "Gross income ZAR" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "age", "in": "query", "required": false, "schema": { "type": "number", "default": 30, "description": "Age (affects tax rebates: primary, 65+, 75+)" }, "description": "Age (affects tax rebates: primary, 65+, 75+)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (15.5%)" }, "description": "VAT registered (15.5%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 21, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_za_post", "summary": "Calculate taxes for South Africa (JSON body)", "description": "South African Tax: Progressive income tax with rebates, UIF", "tags": [ "South Africa" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross income ZAR" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "age": { "type": "number", "default": 30, "description": "Age (affects tax rebates: primary, 65+, 75+)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (15.5%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 21, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/calculate/kr": { "get": { "operationId": "calculate_kr_get", "summary": "Calculate taxes for South Korea", "description": "South Korean Tax: Progressive income tax (6-45%) + 10% local surtax, NPS, NHI, Long-term Care", "tags": [ "South Korea" ], "parameters": [ { "name": "income", "in": "query", "required": true, "schema": { "type": "number", "description": "Gross income KRW" }, "description": "Gross income KRW" }, { "name": "incomePeriod", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" } }, { "name": "includeNps", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "description": "Include National Pension (9% of income, capped)" }, "description": "Include National Pension (9% of income, capped)" }, { "name": "includeEi", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "Include Employment Insurance (2.25%, optional for self-employed)" }, "description": "Include Employment Insurance (2.25%, optional for self-employed)" }, { "name": "vatRegistered", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "description": "VAT registered (10%)" }, "description": "VAT registered (10%)" }, { "name": "weeklyHours", "in": "query", "required": false, "schema": { "type": "number", "default": 40, "description": "Weekly working hours" }, "description": "Weekly working hours" }, { "name": "paidDaysOff", "in": "query", "required": false, "schema": { "type": "number", "default": 15, "description": "Annual leave days" }, "description": "Annual leave days" } ], "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "post": { "operationId": "calculate_kr_post", "summary": "Calculate taxes for South Korea (JSON body)", "description": "South Korean Tax: Progressive income tax (6-45%) + 10% local surtax, NPS, NHI, Long-term Care", "tags": [ "South Korea" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "income": { "type": "number", "description": "Gross income KRW" }, "incomePeriod": { "type": "string", "enum": [ "monthly", "yearly" ], "default": "yearly" }, "includeNps": { "type": "boolean", "default": true, "description": "Include National Pension (9% of income, capped)" }, "includeEi": { "type": "boolean", "default": false, "description": "Include Employment Insurance (2.25%, optional for self-employed)" }, "vatRegistered": { "type": "boolean", "default": false, "description": "VAT registered (10%)" }, "weeklyHours": { "type": "number", "default": 40, "description": "Weekly working hours" }, "paidDaysOff": { "type": "number", "default": 15, "description": "Annual leave days" } }, "required": [ "income" ] } } } }, "responses": { "200": { "description": "Calculation result", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalculationResponse" } } } }, "400": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/v1/countries": { "get": { "operationId": "list_countries", "summary": "List all supported countries", "tags": [ "Countries" ], "responses": { "200": { "description": "List of supported countries", "content": { "application/json": { "schema": { "type": "object", "properties": { "countries": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" }, "currency": { "type": "string", "description": "ISO 4217 currency code" }, "taxYear": { "type": "integer" } }, "required": [ "code", "name", "currency", "taxYear" ] } } } } } } } } } }, "/v1/countries/{countryCode}": { "get": { "operationId": "get_country_docs", "summary": "Get documentation for a specific country", "tags": [ "Countries" ], "parameters": [ { "name": "countryCode", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-z]{2}$" }, "description": "ISO 3166-1 alpha-2 country code" } ], "responses": { "200": { "description": "Country documentation and parameter details", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "404": { "description": "Country not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } } }, "components": { "schemas": { "CalculationResponse": { "type": "object", "required": [ "country", "currency", "taxYear", "input", "monthly", "yearly", "rates" ], "properties": { "country": { "type": "string", "description": "ISO 3166-1 alpha-2 country code" }, "currency": { "type": "string", "description": "ISO 4217 currency code (e.g. EUR, USD, GBP)" }, "taxYear": { "type": "integer" }, "input": { "type": "object", "description": "Echo of the input parameters used for calculation", "additionalProperties": true }, "monthly": { "type": "object", "required": [ "gross", "totalDeductions", "net" ], "properties": { "gross": { "type": "number" }, "vat": { "type": "number" }, "grossWithVat": { "type": "number" }, "socialInsurance": { "type": "number" }, "healthInsurance": { "type": "number" }, "incomeTax": { "type": "number" }, "totalDeductions": { "type": "number" }, "net": { "type": "number" } }, "additionalProperties": true }, "yearly": { "type": "object", "required": [ "gross", "totalDeductions", "net" ], "properties": { "gross": { "type": "number" }, "socialInsurance": { "type": "number" }, "healthInsurance": { "type": "number" }, "incomeTax": { "type": "number" }, "totalDeductions": { "type": "number" }, "net": { "type": "number" } }, "additionalProperties": true }, "rates": { "type": "object", "required": [ "effectiveTaxRate", "dailyRate", "hourlyRate", "workingDays" ], "properties": { "effectiveTaxRate": { "type": "number", "description": "Total deductions as fraction of gross (0-1)" }, "dailyRate": { "type": "number", "description": "Net daily rate" }, "hourlyRate": { "type": "number", "description": "Net hourly rate" }, "workingDays": { "type": "integer", "description": "Working days in the tax year" } } }, "details": { "type": "object", "description": "Country-specific calculation details (e.g., ZUS, health, PIT for Poland)", "additionalProperties": true } }, "example": { "country": "de", "currency": "EUR", "taxYear": 2025, "input": { "income": 60000, "incomePeriod": "yearly" }, "monthly": { "gross": 5000, "vat": 0, "grossWithVat": 5000, "socialInsurance": 846.89, "healthInsurance": 0, "incomeTax": 671.83, "totalDeductions": 1518.72, "net": 3481.28 }, "yearly": { "gross": 60000, "socialInsurance": 10162.68, "healthInsurance": 0, "incomeTax": 8061.92, "totalDeductions": 18224.6, "net": 41775.4 }, "rates": { "effectiveTaxRate": 0.3037, "dailyRate": 189.03, "hourlyRate": 23.63, "workingDays": 221 }, "details": {} } }, "ErrorResponse": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "string", "description": "Human-readable error message" }, "code": { "type": "string", "description": "Machine-readable error code (e.g. VALIDATION_ERROR)" }, "hint": { "type": "string", "description": "Suggested next action for the caller" }, "docs": { "type": "string", "description": "URL to relevant documentation" } } } } } }