{"openapi":"3.1.0","info":{"title":"SalaryAPI Public API","version":"1.0.0","description":"Public API for gross annual salary benchmarks and gross-to-net salary calculations. Both endpoints use Bearer API keys and the same account quota model."},"servers":[{"url":"https://salaryapi.com"}],"externalDocs":{"description":"Human-readable API documentation","url":"https://salaryapi.com/developers"},"tags":[{"name":"Salary benchmarks","description":"Gross annual base salary ranges by role, level, location, and currency."},{"name":"Net salary","description":"Gross-to-net annual, monthly, and hourly salary calculations by country."}],"paths":{"/api/v1/salary-benchmarks":{"post":{"tags":["Salary benchmarks"],"operationId":"createSalaryBenchmark","summary":"Search salary benchmark ranges","description":"Returns gross annual base salary percentiles, separate variable-pay estimates when available, hourly equivalent, no-result state, and shared quota metadata.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["jobTitle"],"properties":{"jobTitle":{"type":"string","minLength":2,"maxLength":80,"description":"Real job title or paid work role to benchmark."},"location":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","maxLength":80},"state":{"type":"string","maxLength":80},"city":{"type":"string","maxLength":80}}},"currency":{"type":"string","minLength":3,"maxLength":3,"enum":["USD","EUR","GBP","JPY","CAD","AUD","CHF","CNY","HKD","SGD","NZD","SEK","NOK","DKK","PLN","CZK","HUF","RON","TRY","UAH","RUB","ILS","AED","SAR","QAR","KWD","BHD","OMR","JOD","INR","PKR","BDT","LKR","IDR","THB","MYR","PHP","VND","KRW","TWD","MXN","BRL","CLP","COP","PEN","ARS","ZAR","EGP","NGN","KES","GHS","TND","MAD","AFN","BOB","CDF","CUP","DZD","ETB","IQD","IRR","KHR","MDL","MGA","MMK","NPR","RSD","SDG","TZS","UZS","XOF","YER"],"default":"USD","description":"Supported 3-letter currency code for the response values."},"seniority":{"type":"string","maxLength":40,"default":"any"}}},"example":{"jobTitle":"Platform Engineer","location":{"country":"Bulgaria","city":"Sofia"},"currency":"EUR","seniority":"mid"}}}},"responses":{"200":{"description":"Salary benchmark result.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["result","quota"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["found","jobTitle","seniority","currency","salaryPeriod","annualBaseSalary","variableCompensation","hourlyEquivalent"],"properties":{"found":{"type":"boolean"},"jobTitle":{"type":"string"},"seniority":{"type":"string"},"currency":{"type":"string","minLength":3,"maxLength":3},"salaryPeriod":{"type":"string","enum":["annual"]},"annualBaseSalary":{"oneOf":[{"type":"object","additionalProperties":false,"required":["p10","p25","median","p75","p90"],"properties":{"p10":{"type":"number","minimum":0},"p25":{"type":"number","minimum":0},"median":{"type":"number","minimum":0},"p75":{"type":"number","minimum":0},"p90":{"type":"number","minimum":0}}},{"type":"null"}]},"variableCompensation":{"oneOf":[{"type":"object","additionalProperties":false,"required":["type","typicalPercentOfBase","percentRange"],"properties":{"type":{"type":"string","enum":["bonus","commission","tips","profit_sharing","mixed","other"]},"typicalPercentOfBase":{"oneOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"null"}]},"percentRange":{"oneOf":[{"type":"object","additionalProperties":false,"required":["p25","median","p75"],"properties":{"p25":{"type":"number","minimum":0,"maximum":1000},"median":{"type":"number","minimum":0,"maximum":1000},"p75":{"type":"number","minimum":0,"maximum":1000}}},{"type":"null"}]}}},{"type":"null"}]},"hourlyEquivalent":{"oneOf":[{"type":"object","additionalProperties":false,"required":["median"],"properties":{"median":{"type":"number","minimum":0}}},{"type":"null"}]}}},"quota":{"type":"object","additionalProperties":false,"required":["allowed","limit","used","remaining","resetAt"],"properties":{"allowed":{"type":"boolean"},"limit":{"type":"integer","minimum":0},"used":{"type":"integer","minimum":0},"remaining":{"type":"integer","minimum":0},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"result":{"found":true,"jobTitle":"Platform Engineer","seniority":"mid","currency":"EUR","salaryPeriod":"annual","annualBaseSalary":{"p10":22000,"p25":28000,"median":36000,"p75":47000,"p90":61000},"variableCompensation":{"type":"bonus","typicalPercentOfBase":10,"percentRange":{"p25":5,"median":10,"p75":15}},"hourlyEquivalent":{"median":17.31}},"quota":{"allowed":true,"limit":3000,"used":14,"remaining":2986,"resetAt":"2026-07-25T12:00:00.000Z"}}}}},"400":{"description":"Invalid salary benchmark payload.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"401":{"description":"Missing or invalid Bearer API key.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"403":{"description":"API access is not allowed for this account or key.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"413":{"description":"Request body is too large.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"415":{"description":"Request body must be JSON.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"429":{"description":"Account quota or short-window API rate limit exceeded.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"500":{"description":"Unexpected server error.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"503":{"description":"Request processing is temporarily unavailable.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"504":{"description":"Salary lookup exceeded its processing deadline.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}}}}},"/api/v1/net-salary":{"post":{"tags":["Net salary"],"operationId":"calculateNetSalary","summary":"Calculate net salary","description":"Converts one gross salary input plus country into estimated net annual, monthly, and hourly pay with deductions and assumptions.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["country"],"properties":{"country":{"type":"string","minLength":2,"maxLength":80,"description":"Supported country code or English country label.","examples":["US","United States","BG","Bulgaria"]},"annualSalary":{"type":"number","minimum":0,"maximum":1000000000000,"description":"Gross annual salary before tax, expressed in the calculator currency for the selected country. Send exactly one salary input."},"monthlySalary":{"type":"number","minimum":0,"maximum":83333333333.33333,"description":"Gross monthly salary before tax, expressed in the calculator currency for the selected country. Send exactly one salary input."},"salary":{"type":"number","minimum":0,"maximum":1000000000000,"description":"Generic gross salary amount in the calculator currency for the selected country. Use salaryPeriod or period to send monthly salary; defaults to annual when omitted."},"salaryPeriod":{"type":"string","enum":["annual","monthly"],"description":"Optional period for the generic salary field. Defaults to annual when omitted."},"period":{"type":"string","enum":["annual","monthly"],"description":"Alias for salaryPeriod. If both are sent, they must match."},"options":{"type":"object","additionalProperties":false,"properties":{"us":{"type":"object","description":"Federal filing status, pre-tax deductions, and optional flat state/local estimate.","additionalProperties":false,"properties":{"filingStatus":{"type":"string","description":"one of: single, marriedJoint, headOfHousehold. Federal filing status used for brackets and standard deduction.","enum":["single","marriedJoint","headOfHousehold"]},"annualPreTaxDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pre-tax deductions subtracted before income tax where supported by the calculator.","minimum":0,"maximum":1000000000000},"stateLocalTaxRatePercent":{"type":"number","description":"finite number from 0 to 20. Optional flat state/local income-tax estimate.","minimum":0,"maximum":20}},"example":{"filingStatus":"single","annualPreTaxDeductions":12000,"stateLocalTaxRatePercent":5}},"unitedKingdom":{"type":"object","description":"Tax region and optional pension contribution settings.","additionalProperties":false,"properties":{"taxRegion":{"type":"string","description":"one of: englandWalesNorthernIreland, scotland. Income-tax region.","enum":["englandWalesNorthernIreland","scotland"]},"pensionContributionRatePercent":{"type":"number","description":"finite number from 0 to 100. Employee pension contribution rate.","minimum":0,"maximum":100},"pensionContributionBasis":{"type":"string","description":"one of: qualifyingEarnings, grossPay. Pay basis used for pension contribution.","enum":["qualifyingEarnings","grossPay"]},"pensionReliefMethod":{"type":"string","description":"one of: netPay, reliefAtSource. Pension tax-relief method.","enum":["netPay","reliefAtSource"]}},"example":{"taxRegion":"englandWalesNorthernIreland","pensionContributionRatePercent":5,"pensionContributionBasis":"grossPay","pensionReliefMethod":"netPay"}},"denmark":{"type":"object","description":"Municipal and church tax overrides.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 35. Municipal tax rate override.","minimum":0,"maximum":35},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 2. Optional church tax rate.","minimum":0,"maximum":2}},"example":{"municipalTaxRatePercent":25.1,"churchTaxRatePercent":0.7}},"japan":{"type":"object","description":"Health insurance, care insurance, and resident tax settings.","additionalProperties":false,"properties":{"healthInsuranceRatePercent":{"type":"number","description":"finite number from 0 to 8. Employee health-insurance rate override.","minimum":0,"maximum":8},"careInsuranceStatus":{"type":"string","description":"one of: notApplicable, age40To64. Care-insurance applicability.","enum":["notApplicable","age40To64"]},"residentTaxRatePercent":{"type":"number","description":"finite number from 0 to 15. Resident tax rate override.","minimum":0,"maximum":15}},"example":{"careInsuranceStatus":"age40To64","residentTaxRatePercent":10}},"malta":{"type":"object","description":"Resident tax status and social-security age band.","additionalProperties":false,"properties":{"taxStatus":{"type":"string","description":"one of: single, married, marriedOneChild, marriedTwoOrMoreChildren, parent, parentOneChild, parentTwoOrMoreChildren. Resident income-tax status.","enum":["single","married","marriedOneChild","marriedTwoOrMoreChildren","parent","parentOneChild","parentTwoOrMoreChildren"]},"socialSecurityAgeBand":{"type":"string","description":"one of: born1962OrLater, bornUpTo1961. Class 1 social-security age band.","enum":["born1962OrLater","bornUpTo1961"]}},"example":{"taxStatus":"single","socialSecurityAgeBand":"born1962OrLater"}},"newZealand":{"type":"object","description":"KiwiSaver and student-loan deduction rates.","additionalProperties":false,"properties":{"kiwiSaverRatePercent":{"type":"number","description":"finite number from 0 to 10. KiwiSaver employee contribution rate.","minimum":0,"maximum":10},"studentLoanRatePercent":{"type":"number","description":"finite number from 0 to 12. Student-loan repayment rate.","minimum":0,"maximum":12}},"example":{"kiwiSaverRatePercent":3,"studentLoanRatePercent":12}},"australia":{"type":"object","description":"HELP/STSL study-loan repayment status.","additionalProperties":false,"properties":{"studyLoanStatus":{"type":"string","description":"one of: none, studyLoan. Study-loan repayment mode.","enum":["none","studyLoan"]}},"example":{"studyLoanStatus":"studyLoan"}},"france":{"type":"object","description":"Household tax parts for income-tax estimate.","additionalProperties":false,"properties":{"taxParts":{"type":"number","description":"finite number from 1 to 10. French household tax parts.","minimum":1,"maximum":10}},"example":{"taxParts":1}},"israel":{"type":"object","description":"Tax credit points and employee pension rate.","additionalProperties":false,"properties":{"taxCreditPoints":{"type":"number","description":"finite number from 0 to 20. Income-tax credit points.","minimum":0,"maximum":20},"pensionRatePercent":{"type":"number","description":"finite number from 0 to 20. Employee pension contribution rate.","minimum":0,"maximum":20}},"example":{"taxCreditPoints":2.25,"pensionRatePercent":6}},"italy":{"type":"object","description":"Employee social-security and local surtax rates.","additionalProperties":false,"properties":{"employeeSocialSecurityRatePercent":{"type":"number","description":"finite number from 0 to 15. Employee social-security contribution rate override.","minimum":0,"maximum":15},"regionalTaxRatePercent":{"type":"number","description":"finite number from 0 to 3.33. Regional surtax rate.","minimum":0,"maximum":3.33},"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 0.9. Municipal surtax rate.","minimum":0,"maximum":0.9}},"example":{"employeeSocialSecurityRatePercent":9.19,"regionalTaxRatePercent":1.23,"municipalTaxRatePercent":0.8}},"ireland":{"type":"object","description":"PAYE profile, USC, PRSI period, partner income, pension, and extra credits.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: single, singleParent, marriedOneIncome, marriedTwoIncomes. PAYE tax profile.","enum":["single","singleParent","marriedOneIncome","marriedTwoIncomes"]},"uscStatus":{"type":"string","description":"one of: standard, reduced. USC rate profile.","enum":["standard","reduced"]},"prsiPeriod":{"type":"string","description":"one of: fullYear2026, beforeOctober2026, fromOctober2026. PRSI period rate.","enum":["fullYear2026","beforeOctober2026","fromOctober2026"]},"partnerIncomeAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual partner income for married two-income calculations.","minimum":0,"maximum":1000000000000},"pensionContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pension contribution.","minimum":0,"maximum":1000000000000},"additionalTaxCreditsAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Additional annual tax credits.","minimum":0,"maximum":1000000000000}},"example":{"taxProfile":"single","uscStatus":"standard","pensionContributionAnnual":3000}},"finland":{"type":"object","description":"Municipal/church tax and public broadcasting tax switch.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 12. Municipal income-tax rate.","minimum":0,"maximum":12},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 2.25. Optional church tax rate.","minimum":0,"maximum":2.25},"includePublicBroadcastingTax":{"type":"boolean","description":"true or false. Whether to include public broadcasting tax."}},"example":{"municipalTaxRatePercent":7.5,"includePublicBroadcastingTax":true}},"czechia":{"type":"object","description":"Taxpayer credit and social/health insurance profile.","additionalProperties":false,"properties":{"taxpayerCredit":{"type":"string","description":"one of: claimed, notClaimed. Basic taxpayer credit treatment.","enum":["claimed","notClaimed"]},"socialInsuranceProfile":{"type":"string","description":"one of: standard, workingPensionerDiscount, notInsured. Social-insurance mode.","enum":["standard","workingPensionerDiscount","notInsured"]},"healthMinimumBase":{"type":"string","description":"one of: standard, exempt. Health-insurance minimum-base treatment.","enum":["standard","exempt"]}},"example":{"taxpayerCredit":"claimed","socialInsuranceProfile":"standard"}},"cuba":{"type":"object","description":"Special social-security contribution status.","additionalProperties":false,"properties":{"socialSecurityStatus":{"type":"string","description":"one of: standard, notContributing. Social-security contribution mode.","enum":["standard","notContributing"]}},"example":{"socialSecurityStatus":"standard"}},"hungary":{"type":"object","description":"Allowance eligibility, PIT exemption profile, children counts, and first-marriage months.","additionalProperties":false,"properties":{"allowanceEligibility":{"type":"string","description":"one of: eligible, notEligible. Tax-base allowance eligibility.","enum":["eligible","notEligible"]},"pitExemptionProfile":{"type":"string","description":"one of: none, under25, motherUnder30, motherTwoChildrenUnder40, motherThreeOrMoreChildren, motherFourOrMoreChildren. Selected PIT exemption profile.","enum":["none","under25","motherUnder30","motherTwoChildrenUnder40","motherThreeOrMoreChildren","motherFourOrMoreChildren"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 100. Dependent children count.","minimum":0,"maximum":100},"disabledDependentChildren":{"type":"integer","description":"integer from 0 to 100. Disabled dependent children count.","minimum":0,"maximum":100},"severeDisabilityPersonalAllowance":{"type":"boolean","description":"true or false. Whether to apply severe-disability personal allowance."},"firstMarriageMonths":{"type":"integer","description":"integer from 0 to 12. Months eligible for first-marriage allowance in the estimated tax year.","minimum":0,"maximum":12}},"example":{"allowanceEligibility":"eligible","pitExemptionProfile":"none","dependentChildren":1}},"iran":{"type":"object","description":"Employee social-insurance status.","additionalProperties":false,"properties":{"socialInsuranceStatus":{"type":"string","description":"one of: insuredCapped, notInsured. Social-insurance mode.","enum":["insuredCapped","notInsured"]}},"example":{"socialInsuranceStatus":"insuredCapped"}},"iraq":{"type":"object","description":"Tax profile, social-security mode, dependents, age flag, and risk allowance.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: bachelor, married. Personal allowance profile.","enum":["bachelor","married"]},"socialSecurityStatus":{"type":"string","description":"one of: insuredCapped, notInsured. Social-security mode.","enum":["insuredCapped","notInsured"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 100. Dependent children count.","minimum":0,"maximum":100},"over63":{"type":"boolean","description":"true or false. Whether the taxpayer is over 63."},"riskAllowancePercent":{"type":"number","description":"finite number from 0 to 30. Optional risk allowance percentage.","minimum":0,"maximum":30}},"example":{"taxProfile":"married","socialSecurityStatus":"insuredCapped","dependentChildren":2}},"mexico":{"type":"object","description":"IMSS wage-base factor.","additionalProperties":false,"properties":{"imssWageBaseFactor":{"type":"number","description":"finite number from 0.01 to 2. IMSS wage-base factor.","minimum":0.01,"maximum":2}},"example":{"imssWageBaseFactor":1}},"egypt":{"type":"object","description":"Social-insurance wage factor.","additionalProperties":false,"properties":{"socialInsuranceWageFactor":{"type":"number","description":"finite number from 0.01 to 2. Social-insurance wage factor.","minimum":0.01,"maximum":2}},"example":{"socialInsuranceWageFactor":1}},"afghanistan":{"type":"object","description":"Public/private pension profile.","additionalProperties":false,"properties":{"pensionProfile":{"type":"string","description":"one of: privateSector, civilService, securityForces. Pension deduction profile.","enum":["privateSector","civilService","securityForces"]}},"example":{"pensionProfile":"privateSector"}},"greece":{"type":"object","description":"Age band and dependent children.","additionalProperties":false,"properties":{"ageBand":{"type":"string","description":"one of: standard, upTo25, age26To30. Worker age band.","enum":["standard","upTo25","age26To30"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 12. Dependent children count.","minimum":0,"maximum":12}},"example":{"ageBand":"standard","dependentChildren":1}},"india":{"type":"object","description":"EPF wage factor/cap and professional tax.","additionalProperties":false,"properties":{"epfWageFactor":{"type":"number","description":"finite number from 0 to 1. EPF wage factor.","minimum":0,"maximum":1},"epfMonthlyWageCap":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. EPF monthly wage cap.","minimum":0,"maximum":1000000000000},"professionalTaxAnnual":{"type":"number","description":"finite number from 0 to 2,500. Annual professional tax.","minimum":0,"maximum":2500}},"example":{"epfWageFactor":1,"professionalTaxAnnual":2500}},"sweden":{"type":"object","description":"Municipal income-tax rate.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 40. Municipal income-tax rate.","minimum":0,"maximum":40}},"example":{"municipalTaxRatePercent":32}},"brazil":{"type":"object","description":"Dependent count and other monthly deductions.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"otherMonthlyDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Other monthly deductions.","minimum":0,"maximum":1000000000000}},"example":{"dependents":1,"otherMonthlyDeductions":500}},"argentina":{"type":"object","description":"Spouse deduction and child count.","additionalProperties":false,"properties":{"spouseDeduction":{"type":"string","description":"one of: notClaimed, claimed. Spouse deduction status.","enum":["notClaimed","claimed"]},"children":{"type":"integer","description":"integer from 0 to 10. Child count.","minimum":0,"maximum":10}},"example":{"spouseDeduction":"notClaimed","children":1}},"romania":{"type":"object","description":"Dependents, enrolled children, young-employee status, and minimum-wage relief mode.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"enrolledChildren":{"type":"integer","description":"integer from 0 to 20. Enrolled children count.","minimum":0,"maximum":20},"youngEmployeeStatus":{"type":"string","description":"one of: standard, under26. Young employee treatment.","enum":["standard","under26"]},"minimumWageReliefStatus":{"type":"string","description":"one of: auto, off. Minimum-wage relief treatment.","enum":["auto","off"]}},"example":{"dependents":1,"minimumWageReliefStatus":"auto"}},"portugal":{"type":"object","description":"Tax situation, dependents, and pay periods.","additionalProperties":false,"properties":{"taxSituation":{"type":"string","description":"one of: singleNoDependentsOrMarriedTwoEarners, singleWithDependents, marriedSingleEarner. IRS withholding situation.","enum":["singleNoDependentsOrMarriedTwoEarners","singleWithDependents","marriedSingleEarner"]},"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"payPeriods":{"type":"integer","description":"one of: 12, 14. Number of annual salary payment periods.","enum":[12,14]}},"example":{"taxSituation":"singleNoDependentsOrMarriedTwoEarners","payPeriods":14}},"spain":{"type":"object","description":"Regional income-tax rate override.","additionalProperties":false,"properties":{"regionalTaxRatePercent":{"type":"number","description":"finite number from 0 to 10. Regional IRPF rate adjustment.","minimum":0,"maximum":10}},"example":{"regionalTaxRatePercent":9.5}},"democraticRepublicOfTheCongo":{"type":"object","description":"Dependent count.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 9. Dependent count.","minimum":0,"maximum":9}},"example":{"dependents":2}},"indonesia":{"type":"object","description":"Tax status and dependent count.","additionalProperties":false,"properties":{"taxStatus":{"type":"string","description":"one of: single, married. PTKP tax status.","enum":["single","married"]},"dependents":{"type":"integer","description":"integer from 0 to 3. Dependent count.","minimum":0,"maximum":3}},"example":{"taxStatus":"single","dependents":1}},"netherlands":{"type":"object","description":"Payroll tax credit and employee pension rate.","additionalProperties":false,"properties":{"payrollTaxCredit":{"type":"string","description":"one of: applied, notApplied. Payroll tax credit treatment.","enum":["applied","notApplied"]},"employeePensionRatePercent":{"type":"number","description":"finite number from 0 to 30. Employee pension contribution rate.","minimum":0,"maximum":30}},"example":{"payrollTaxCredit":"applied","employeePensionRatePercent":5}},"bangladesh":{"type":"object","description":"Taxpayer category and allowable investments.","additionalProperties":false,"properties":{"taxpayerCategory":{"type":"string","description":"one of: general, womanOrSenior, disabledOrThirdGender, warWoundedFreedomFighter. Taxpayer threshold category.","enum":["general","womanOrSenior","disabledOrThirdGender","warWoundedFreedomFighter"]},"allowableInvestmentsAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual allowable investments for rebate estimate.","minimum":0,"maximum":1000000000000}},"example":{"taxpayerCategory":"general","allowableInvestmentsAnnual":100000}},"canada":{"type":"object","description":"Province selection and annual pre-tax deductions.","additionalProperties":false,"properties":{"province":{"type":"string","description":"one of: ON, BC, AB. Province used for province income tax.","enum":["ON","BC","AB"]},"annualPreTaxDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pre-tax deductions.","minimum":0,"maximum":1000000000000}},"example":{"province":"ON","annualPreTaxDeductions":0}},"belgium":{"type":"object","description":"Municipal tax rate.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 9. Municipal tax rate.","minimum":0,"maximum":9}},"example":{"municipalTaxRatePercent":7}},"china":{"type":"object","description":"Employee social and housing fund rate.","additionalProperties":false,"properties":{"employeeSocialHousingRatePercent":{"type":"number","description":"finite number from 0 to 40. Employee social insurance and housing fund rate.","minimum":0,"maximum":40}},"example":{"employeeSocialHousingRatePercent":18}},"switzerland":{"type":"object","description":"Occupational pension and canton/commune/church tax rates.","additionalProperties":false,"properties":{"occupationalPensionRatePercent":{"type":"number","description":"finite number from 0 to 25. Occupational pension contribution rate.","minimum":0,"maximum":25},"cantonCommuneChurchTaxRatePercent":{"type":"number","description":"finite number from 0 to 30. Combined canton, commune, and church tax estimate.","minimum":0,"maximum":30}},"example":{"occupationalPensionRatePercent":7,"cantonCommuneChurchTaxRatePercent":8}},"unitedArabEmirates":{"type":"object","description":"Employee pension rate.","additionalProperties":false,"properties":{"employeePensionRatePercent":{"type":"number","description":"finite number from 0 to 20. Optional employee pension or social-security rate.","minimum":0,"maximum":20}},"example":{"employeePensionRatePercent":5}},"qatar":{"type":"object","description":"Employee social-insurance rate.","additionalProperties":false,"properties":{"employeeSocialInsuranceRatePercent":{"type":"number","description":"finite number from 0 to 7. Optional employee social-insurance rate.","minimum":0,"maximum":7}},"example":{"employeeSocialInsuranceRatePercent":5}},"singapore":{"type":"object","description":"Tax residency, CPF profile, and CPF age band.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Income-tax residency.","enum":["resident","nonResident"]},"cpfProfile":{"type":"string","description":"one of: citizenOrSprThirdYear, noCpf. CPF contribution profile.","enum":["citizenOrSprThirdYear","noCpf"]},"cpfAgeBand":{"type":"string","description":"one of: upTo55, age55To60, age60To65, age65To70, above70. CPF age band.","enum":["upTo55","age55To60","age60To65","age65To70","above70"]}},"example":{"taxResidency":"resident","cpfProfile":"citizenOrSprThirdYear","cpfAgeBand":"upTo55"}},"tanzania":{"type":"object","description":"Employment status and retirement scheme.","additionalProperties":false,"properties":{"employmentStatus":{"type":"string","description":"one of: residentPrimary, residentSecondary, nonResident. PAYE employment/residency status.","enum":["residentPrimary","residentSecondary","nonResident"]},"retirementScheme":{"type":"string","description":"one of: nssfStandard, nssfFivePercent, psssf, none. Retirement contribution scheme.","enum":["nssfStandard","nssfFivePercent","psssf","none"]}},"example":{"employmentStatus":"residentPrimary","retirementScheme":"nssfStandard"}},"sudan":{"type":"object","description":"Tax residency and statutory contribution status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Employment tax residency.","enum":["resident","nonResident"]},"statutoryContributionStatus":{"type":"string","description":"one of: formalSector, pensionOnly, notContributing. Pension/health contribution mode.","enum":["formalSector","pensionOnly","notContributing"]}},"example":{"taxResidency":"resident","statutoryContributionStatus":"formalSector"}},"peru":{"type":"object","description":"Tax residency and pension system.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: domiciled, nonDomiciled. Tax residency.","enum":["domiciled","nonDomiciled"]},"pensionSystem":{"type":"string","description":"one of: afpMixed, afpHabitatFlow, afpIntegraFlow, afpPrimaFlow, afpProfuturoFlow, onp, none. Pension system.","enum":["afpMixed","afpHabitatFlow","afpIntegraFlow","afpPrimaFlow","afpProfuturoFlow","onp","none"]}},"example":{"taxResidency":"domiciled","pensionSystem":"onp"}},"bolivia":{"type":"object","description":"Social contribution status and VAT invoice credit.","additionalProperties":false,"properties":{"socialContributionStatus":{"type":"string","description":"one of: contributing, employee65Plus, notContributing. Pension contribution mode.","enum":["contributing","employee65Plus","notContributing"]},"vatInvoiceCreditAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual VAT invoice credit.","minimum":0,"maximum":1000000000000}},"example":{"socialContributionStatus":"contributing","vatInvoiceCreditAnnual":12000}},"coteDIvoire":{"type":"object","description":"Family parts for RICF reduction.","additionalProperties":false,"properties":{"familyParts":{"type":"string","description":"one of: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5. Family parts.","enum":["1","1.5","2","2.5","3","3.5","4","4.5","5"]}},"example":{"familyParts":"1"}},"cambodia":{"type":"object","description":"Tax residency, spouse/dependents count, and NSSF pension status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Salary tax residency.","enum":["resident","nonResident"]},"dependentsAndSpouse":{"type":"integer","description":"integer from 0 to 20. Dependents and spouse count.","minimum":0,"maximum":20},"nssfPensionStatus":{"type":"string","description":"one of: participating, notParticipating. NSSF pension participation.","enum":["participating","notParticipating"]}},"example":{"taxResidency":"resident","dependentsAndSpouse":1,"nssfPensionStatus":"participating"}},"northKorea":{"type":"object","description":"Worker profile and foreign income-tax rate.","additionalProperties":false,"properties":{"workerProfile":{"type":"string","description":"one of: domesticCitizen, foreignIndividual, foreignResident. Worker profile.","enum":["domesticCitizen","foreignIndividual","foreignResident"]},"foreignIncomeTaxRatePercent":{"type":"number","description":"finite number from 5 to 30. Foreign individual income-tax rate.","minimum":5,"maximum":30}},"example":{"workerProfile":"domesticCitizen"}},"nepal":{"type":"object","description":"Tax profile, SSF, insurance deductions, remote-area category, and credits.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: residentSingle, residentCouple, nonResident. Salary tax profile.","enum":["residentSingle","residentCouple","nonResident"]},"ssfContributionStatus":{"type":"string","description":"one of: ssfContributor, notContributing. SSF participation.","enum":["ssfContributor","notContributing"]},"ssfBasicSalaryPercent":{"type":"number","description":"finite number from 0 to 100. SSF basic salary percentage.","minimum":0,"maximum":100},"lifeInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 40,000. Annual life-insurance premium.","minimum":0,"maximum":40000},"healthInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 20,000. Annual health-insurance premium.","minimum":0,"maximum":20000},"buildingInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 5,000. Annual building-insurance premium.","minimum":0,"maximum":5000},"remoteAreaCategory":{"type":"string","description":"one of: none, A, B, C, D, E. Remote-area deduction category.","enum":["none","A","B","C","D","E"]},"femaleTaxCreditStatus":{"type":"string","description":"one of: notClaimed, singleFemaleEmploymentIncome. Female employment-income credit status.","enum":["notClaimed","singleFemaleEmploymentIncome"]},"medicalExpenseAnnual":{"type":"number","description":"finite number from 0 to 10,000. Annual medical expense.","minimum":0,"maximum":10000}},"example":{"taxProfile":"residentSingle","ssfContributionStatus":"ssfContributor","remoteAreaCategory":"none"}},"myanmar":{"type":"object","description":"Tax profile, SSB status, spouse allowance, children, parents, insurance, and savings fund.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: resident, nonResidentForeign, nonResidentCitizenAbroad. Salary tax profile.","enum":["resident","nonResidentForeign","nonResidentCitizenAbroad"]},"ssbContributionStatus":{"type":"string","description":"one of: ssbContributor, notContributing. SSB contribution status.","enum":["ssbContributor","notContributing"]},"spouseAllowance":{"type":"string","description":"one of: notClaimed, claimed. Spouse allowance status.","enum":["notClaimed","claimed"]},"children":{"type":"integer","description":"integer from 0 to 10. Child count.","minimum":0,"maximum":10},"dependentParents":{"type":"integer","description":"integer from 0 to 4. Dependent parents count.","minimum":0,"maximum":4},"lifeInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual life-insurance premium.","minimum":0,"maximum":1000000000000},"savingsFundContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual savings-fund contribution.","minimum":0,"maximum":1000000000000}},"example":{"taxProfile":"resident","ssbContributionStatus":"ssbContributor","spouseAllowance":"notClaimed"}},"moldova":{"type":"object","description":"Personal/spouse allowances, dependents, and health-insurance status.","additionalProperties":false,"properties":{"personalAllowance":{"type":"string","description":"one of: standard, major, notClaimed. Personal allowance status.","enum":["standard","major","notClaimed"]},"spouseAllowance":{"type":"string","description":"one of: notClaimed, majorSpouse. Spouse allowance status.","enum":["notClaimed","majorSpouse"]},"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"severeDisabilityDependents":{"type":"integer","description":"integer from 0 to 20. Severe-disability dependent count.","minimum":0,"maximum":20},"healthInsuranceStatus":{"type":"string","description":"one of: contributing, notContributing. Health-insurance contribution status.","enum":["contributing","notContributing"]}},"example":{"personalAllowance":"standard","spouseAllowance":"notClaimed","dependents":1}},"madagascar":{"type":"object","description":"Social contribution status, dependents, and monthly contribution cap.","additionalProperties":false,"properties":{"socialContributionStatus":{"type":"string","description":"one of: cnapsAndHealth, cnapsOnly, notContributing. Social contribution mode.","enum":["cnapsAndHealth","cnapsOnly","notContributing"]},"dependents":{"type":"integer","description":"integer from 0 to 50. Dependent count.","minimum":0,"maximum":50},"monthlyContributionCap":{"type":"number","description":"finite number from 1 to 100,000,000. Monthly contribution cap.","minimum":1,"maximum":100000000}},"example":{"socialContributionStatus":"cnapsAndHealth","dependents":1}},"kenya":{"type":"object","description":"Tax residency, NSSF mode, pension, insurance, medical fund, and mortgage interest.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. PAYE tax residency.","enum":["resident","nonResident"]},"nssfContributionStatus":{"type":"string","description":"one of: tierIAndII, notContributing. NSSF contribution status.","enum":["tierIAndII","notContributing"]},"additionalPensionContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual additional pension contribution.","minimum":0,"maximum":1000000000000},"insurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 400,000. Annual insurance premium.","minimum":0,"maximum":400000},"postRetirementMedicalFundAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual post-retirement medical fund contribution.","minimum":0,"maximum":1000000000000},"mortgageInterestAnnual":{"type":"number","description":"finite number from 0 to 360,000. Annual mortgage interest.","minimum":0,"maximum":360000}},"example":{"taxResidency":"resident","nssfContributionStatus":"tierIAndII"}},"uzbekistan":{"type":"object","description":"Tax residency and INPS participation.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Tax residency.","enum":["resident","nonResident"]},"inpsParticipation":{"type":"string","description":"one of: participant, notParticipating. INPS participation.","enum":["participant","notParticipating"]}},"example":{"taxResidency":"resident","inpsParticipation":"participant"}},"yemen":{"type":"object","description":"Tax residency and social-insurance status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Salary tax residency.","enum":["resident","nonResident"]},"socialInsuranceStatus":{"type":"string","description":"one of: insured, notInsured. Social-insurance status.","enum":["insured","notInsured"]}},"example":{"taxResidency":"resident","socialInsuranceStatus":"insured"}},"germany":{"type":"object","description":"Health add-on, care status, and church tax rate.","additionalProperties":false,"properties":{"healthAdditionalRatePercent":{"type":"number","description":"finite number from 0 to 6. Additional statutory health-insurance rate.","minimum":0,"maximum":6},"careStatus":{"type":"string","description":"one of: withChildren, childless. Long-term care insurance status.","enum":["withChildren","childless"]},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 9. Optional church tax rate.","minimum":0,"maximum":9}},"example":{"healthAdditionalRatePercent":1.7,"careStatus":"withChildren","churchTaxRatePercent":0}}},"description":"Nested country-specific options. Use this or top-level country option keys, not both."},"us":{"type":"object","description":"Federal filing status, pre-tax deductions, and optional flat state/local estimate.","additionalProperties":false,"properties":{"filingStatus":{"type":"string","description":"one of: single, marriedJoint, headOfHousehold. Federal filing status used for brackets and standard deduction.","enum":["single","marriedJoint","headOfHousehold"]},"annualPreTaxDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pre-tax deductions subtracted before income tax where supported by the calculator.","minimum":0,"maximum":1000000000000},"stateLocalTaxRatePercent":{"type":"number","description":"finite number from 0 to 20. Optional flat state/local income-tax estimate.","minimum":0,"maximum":20}},"example":{"filingStatus":"single","annualPreTaxDeductions":12000,"stateLocalTaxRatePercent":5}},"unitedKingdom":{"type":"object","description":"Tax region and optional pension contribution settings.","additionalProperties":false,"properties":{"taxRegion":{"type":"string","description":"one of: englandWalesNorthernIreland, scotland. Income-tax region.","enum":["englandWalesNorthernIreland","scotland"]},"pensionContributionRatePercent":{"type":"number","description":"finite number from 0 to 100. Employee pension contribution rate.","minimum":0,"maximum":100},"pensionContributionBasis":{"type":"string","description":"one of: qualifyingEarnings, grossPay. Pay basis used for pension contribution.","enum":["qualifyingEarnings","grossPay"]},"pensionReliefMethod":{"type":"string","description":"one of: netPay, reliefAtSource. Pension tax-relief method.","enum":["netPay","reliefAtSource"]}},"example":{"taxRegion":"englandWalesNorthernIreland","pensionContributionRatePercent":5,"pensionContributionBasis":"grossPay","pensionReliefMethod":"netPay"}},"denmark":{"type":"object","description":"Municipal and church tax overrides.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 35. Municipal tax rate override.","minimum":0,"maximum":35},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 2. Optional church tax rate.","minimum":0,"maximum":2}},"example":{"municipalTaxRatePercent":25.1,"churchTaxRatePercent":0.7}},"japan":{"type":"object","description":"Health insurance, care insurance, and resident tax settings.","additionalProperties":false,"properties":{"healthInsuranceRatePercent":{"type":"number","description":"finite number from 0 to 8. Employee health-insurance rate override.","minimum":0,"maximum":8},"careInsuranceStatus":{"type":"string","description":"one of: notApplicable, age40To64. Care-insurance applicability.","enum":["notApplicable","age40To64"]},"residentTaxRatePercent":{"type":"number","description":"finite number from 0 to 15. Resident tax rate override.","minimum":0,"maximum":15}},"example":{"careInsuranceStatus":"age40To64","residentTaxRatePercent":10}},"malta":{"type":"object","description":"Resident tax status and social-security age band.","additionalProperties":false,"properties":{"taxStatus":{"type":"string","description":"one of: single, married, marriedOneChild, marriedTwoOrMoreChildren, parent, parentOneChild, parentTwoOrMoreChildren. Resident income-tax status.","enum":["single","married","marriedOneChild","marriedTwoOrMoreChildren","parent","parentOneChild","parentTwoOrMoreChildren"]},"socialSecurityAgeBand":{"type":"string","description":"one of: born1962OrLater, bornUpTo1961. Class 1 social-security age band.","enum":["born1962OrLater","bornUpTo1961"]}},"example":{"taxStatus":"single","socialSecurityAgeBand":"born1962OrLater"}},"newZealand":{"type":"object","description":"KiwiSaver and student-loan deduction rates.","additionalProperties":false,"properties":{"kiwiSaverRatePercent":{"type":"number","description":"finite number from 0 to 10. KiwiSaver employee contribution rate.","minimum":0,"maximum":10},"studentLoanRatePercent":{"type":"number","description":"finite number from 0 to 12. Student-loan repayment rate.","minimum":0,"maximum":12}},"example":{"kiwiSaverRatePercent":3,"studentLoanRatePercent":12}},"australia":{"type":"object","description":"HELP/STSL study-loan repayment status.","additionalProperties":false,"properties":{"studyLoanStatus":{"type":"string","description":"one of: none, studyLoan. Study-loan repayment mode.","enum":["none","studyLoan"]}},"example":{"studyLoanStatus":"studyLoan"}},"france":{"type":"object","description":"Household tax parts for income-tax estimate.","additionalProperties":false,"properties":{"taxParts":{"type":"number","description":"finite number from 1 to 10. French household tax parts.","minimum":1,"maximum":10}},"example":{"taxParts":1}},"israel":{"type":"object","description":"Tax credit points and employee pension rate.","additionalProperties":false,"properties":{"taxCreditPoints":{"type":"number","description":"finite number from 0 to 20. Income-tax credit points.","minimum":0,"maximum":20},"pensionRatePercent":{"type":"number","description":"finite number from 0 to 20. Employee pension contribution rate.","minimum":0,"maximum":20}},"example":{"taxCreditPoints":2.25,"pensionRatePercent":6}},"italy":{"type":"object","description":"Employee social-security and local surtax rates.","additionalProperties":false,"properties":{"employeeSocialSecurityRatePercent":{"type":"number","description":"finite number from 0 to 15. Employee social-security contribution rate override.","minimum":0,"maximum":15},"regionalTaxRatePercent":{"type":"number","description":"finite number from 0 to 3.33. Regional surtax rate.","minimum":0,"maximum":3.33},"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 0.9. Municipal surtax rate.","minimum":0,"maximum":0.9}},"example":{"employeeSocialSecurityRatePercent":9.19,"regionalTaxRatePercent":1.23,"municipalTaxRatePercent":0.8}},"ireland":{"type":"object","description":"PAYE profile, USC, PRSI period, partner income, pension, and extra credits.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: single, singleParent, marriedOneIncome, marriedTwoIncomes. PAYE tax profile.","enum":["single","singleParent","marriedOneIncome","marriedTwoIncomes"]},"uscStatus":{"type":"string","description":"one of: standard, reduced. USC rate profile.","enum":["standard","reduced"]},"prsiPeriod":{"type":"string","description":"one of: fullYear2026, beforeOctober2026, fromOctober2026. PRSI period rate.","enum":["fullYear2026","beforeOctober2026","fromOctober2026"]},"partnerIncomeAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual partner income for married two-income calculations.","minimum":0,"maximum":1000000000000},"pensionContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pension contribution.","minimum":0,"maximum":1000000000000},"additionalTaxCreditsAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Additional annual tax credits.","minimum":0,"maximum":1000000000000}},"example":{"taxProfile":"single","uscStatus":"standard","pensionContributionAnnual":3000}},"finland":{"type":"object","description":"Municipal/church tax and public broadcasting tax switch.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 12. Municipal income-tax rate.","minimum":0,"maximum":12},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 2.25. Optional church tax rate.","minimum":0,"maximum":2.25},"includePublicBroadcastingTax":{"type":"boolean","description":"true or false. Whether to include public broadcasting tax."}},"example":{"municipalTaxRatePercent":7.5,"includePublicBroadcastingTax":true}},"czechia":{"type":"object","description":"Taxpayer credit and social/health insurance profile.","additionalProperties":false,"properties":{"taxpayerCredit":{"type":"string","description":"one of: claimed, notClaimed. Basic taxpayer credit treatment.","enum":["claimed","notClaimed"]},"socialInsuranceProfile":{"type":"string","description":"one of: standard, workingPensionerDiscount, notInsured. Social-insurance mode.","enum":["standard","workingPensionerDiscount","notInsured"]},"healthMinimumBase":{"type":"string","description":"one of: standard, exempt. Health-insurance minimum-base treatment.","enum":["standard","exempt"]}},"example":{"taxpayerCredit":"claimed","socialInsuranceProfile":"standard"}},"cuba":{"type":"object","description":"Special social-security contribution status.","additionalProperties":false,"properties":{"socialSecurityStatus":{"type":"string","description":"one of: standard, notContributing. Social-security contribution mode.","enum":["standard","notContributing"]}},"example":{"socialSecurityStatus":"standard"}},"hungary":{"type":"object","description":"Allowance eligibility, PIT exemption profile, children counts, and first-marriage months.","additionalProperties":false,"properties":{"allowanceEligibility":{"type":"string","description":"one of: eligible, notEligible. Tax-base allowance eligibility.","enum":["eligible","notEligible"]},"pitExemptionProfile":{"type":"string","description":"one of: none, under25, motherUnder30, motherTwoChildrenUnder40, motherThreeOrMoreChildren, motherFourOrMoreChildren. Selected PIT exemption profile.","enum":["none","under25","motherUnder30","motherTwoChildrenUnder40","motherThreeOrMoreChildren","motherFourOrMoreChildren"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 100. Dependent children count.","minimum":0,"maximum":100},"disabledDependentChildren":{"type":"integer","description":"integer from 0 to 100. Disabled dependent children count.","minimum":0,"maximum":100},"severeDisabilityPersonalAllowance":{"type":"boolean","description":"true or false. Whether to apply severe-disability personal allowance."},"firstMarriageMonths":{"type":"integer","description":"integer from 0 to 12. Months eligible for first-marriage allowance in the estimated tax year.","minimum":0,"maximum":12}},"example":{"allowanceEligibility":"eligible","pitExemptionProfile":"none","dependentChildren":1}},"iran":{"type":"object","description":"Employee social-insurance status.","additionalProperties":false,"properties":{"socialInsuranceStatus":{"type":"string","description":"one of: insuredCapped, notInsured. Social-insurance mode.","enum":["insuredCapped","notInsured"]}},"example":{"socialInsuranceStatus":"insuredCapped"}},"iraq":{"type":"object","description":"Tax profile, social-security mode, dependents, age flag, and risk allowance.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: bachelor, married. Personal allowance profile.","enum":["bachelor","married"]},"socialSecurityStatus":{"type":"string","description":"one of: insuredCapped, notInsured. Social-security mode.","enum":["insuredCapped","notInsured"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 100. Dependent children count.","minimum":0,"maximum":100},"over63":{"type":"boolean","description":"true or false. Whether the taxpayer is over 63."},"riskAllowancePercent":{"type":"number","description":"finite number from 0 to 30. Optional risk allowance percentage.","minimum":0,"maximum":30}},"example":{"taxProfile":"married","socialSecurityStatus":"insuredCapped","dependentChildren":2}},"mexico":{"type":"object","description":"IMSS wage-base factor.","additionalProperties":false,"properties":{"imssWageBaseFactor":{"type":"number","description":"finite number from 0.01 to 2. IMSS wage-base factor.","minimum":0.01,"maximum":2}},"example":{"imssWageBaseFactor":1}},"egypt":{"type":"object","description":"Social-insurance wage factor.","additionalProperties":false,"properties":{"socialInsuranceWageFactor":{"type":"number","description":"finite number from 0.01 to 2. Social-insurance wage factor.","minimum":0.01,"maximum":2}},"example":{"socialInsuranceWageFactor":1}},"afghanistan":{"type":"object","description":"Public/private pension profile.","additionalProperties":false,"properties":{"pensionProfile":{"type":"string","description":"one of: privateSector, civilService, securityForces. Pension deduction profile.","enum":["privateSector","civilService","securityForces"]}},"example":{"pensionProfile":"privateSector"}},"greece":{"type":"object","description":"Age band and dependent children.","additionalProperties":false,"properties":{"ageBand":{"type":"string","description":"one of: standard, upTo25, age26To30. Worker age band.","enum":["standard","upTo25","age26To30"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 12. Dependent children count.","minimum":0,"maximum":12}},"example":{"ageBand":"standard","dependentChildren":1}},"india":{"type":"object","description":"EPF wage factor/cap and professional tax.","additionalProperties":false,"properties":{"epfWageFactor":{"type":"number","description":"finite number from 0 to 1. EPF wage factor.","minimum":0,"maximum":1},"epfMonthlyWageCap":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. EPF monthly wage cap.","minimum":0,"maximum":1000000000000},"professionalTaxAnnual":{"type":"number","description":"finite number from 0 to 2,500. Annual professional tax.","minimum":0,"maximum":2500}},"example":{"epfWageFactor":1,"professionalTaxAnnual":2500}},"sweden":{"type":"object","description":"Municipal income-tax rate.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 40. Municipal income-tax rate.","minimum":0,"maximum":40}},"example":{"municipalTaxRatePercent":32}},"brazil":{"type":"object","description":"Dependent count and other monthly deductions.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"otherMonthlyDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Other monthly deductions.","minimum":0,"maximum":1000000000000}},"example":{"dependents":1,"otherMonthlyDeductions":500}},"argentina":{"type":"object","description":"Spouse deduction and child count.","additionalProperties":false,"properties":{"spouseDeduction":{"type":"string","description":"one of: notClaimed, claimed. Spouse deduction status.","enum":["notClaimed","claimed"]},"children":{"type":"integer","description":"integer from 0 to 10. Child count.","minimum":0,"maximum":10}},"example":{"spouseDeduction":"notClaimed","children":1}},"romania":{"type":"object","description":"Dependents, enrolled children, young-employee status, and minimum-wage relief mode.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"enrolledChildren":{"type":"integer","description":"integer from 0 to 20. Enrolled children count.","minimum":0,"maximum":20},"youngEmployeeStatus":{"type":"string","description":"one of: standard, under26. Young employee treatment.","enum":["standard","under26"]},"minimumWageReliefStatus":{"type":"string","description":"one of: auto, off. Minimum-wage relief treatment.","enum":["auto","off"]}},"example":{"dependents":1,"minimumWageReliefStatus":"auto"}},"portugal":{"type":"object","description":"Tax situation, dependents, and pay periods.","additionalProperties":false,"properties":{"taxSituation":{"type":"string","description":"one of: singleNoDependentsOrMarriedTwoEarners, singleWithDependents, marriedSingleEarner. IRS withholding situation.","enum":["singleNoDependentsOrMarriedTwoEarners","singleWithDependents","marriedSingleEarner"]},"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"payPeriods":{"type":"integer","description":"one of: 12, 14. Number of annual salary payment periods.","enum":[12,14]}},"example":{"taxSituation":"singleNoDependentsOrMarriedTwoEarners","payPeriods":14}},"spain":{"type":"object","description":"Regional income-tax rate override.","additionalProperties":false,"properties":{"regionalTaxRatePercent":{"type":"number","description":"finite number from 0 to 10. Regional IRPF rate adjustment.","minimum":0,"maximum":10}},"example":{"regionalTaxRatePercent":9.5}},"democraticRepublicOfTheCongo":{"type":"object","description":"Dependent count.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 9. Dependent count.","minimum":0,"maximum":9}},"example":{"dependents":2}},"indonesia":{"type":"object","description":"Tax status and dependent count.","additionalProperties":false,"properties":{"taxStatus":{"type":"string","description":"one of: single, married. PTKP tax status.","enum":["single","married"]},"dependents":{"type":"integer","description":"integer from 0 to 3. Dependent count.","minimum":0,"maximum":3}},"example":{"taxStatus":"single","dependents":1}},"netherlands":{"type":"object","description":"Payroll tax credit and employee pension rate.","additionalProperties":false,"properties":{"payrollTaxCredit":{"type":"string","description":"one of: applied, notApplied. Payroll tax credit treatment.","enum":["applied","notApplied"]},"employeePensionRatePercent":{"type":"number","description":"finite number from 0 to 30. Employee pension contribution rate.","minimum":0,"maximum":30}},"example":{"payrollTaxCredit":"applied","employeePensionRatePercent":5}},"bangladesh":{"type":"object","description":"Taxpayer category and allowable investments.","additionalProperties":false,"properties":{"taxpayerCategory":{"type":"string","description":"one of: general, womanOrSenior, disabledOrThirdGender, warWoundedFreedomFighter. Taxpayer threshold category.","enum":["general","womanOrSenior","disabledOrThirdGender","warWoundedFreedomFighter"]},"allowableInvestmentsAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual allowable investments for rebate estimate.","minimum":0,"maximum":1000000000000}},"example":{"taxpayerCategory":"general","allowableInvestmentsAnnual":100000}},"canada":{"type":"object","description":"Province selection and annual pre-tax deductions.","additionalProperties":false,"properties":{"province":{"type":"string","description":"one of: ON, BC, AB. Province used for province income tax.","enum":["ON","BC","AB"]},"annualPreTaxDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pre-tax deductions.","minimum":0,"maximum":1000000000000}},"example":{"province":"ON","annualPreTaxDeductions":0}},"belgium":{"type":"object","description":"Municipal tax rate.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 9. Municipal tax rate.","minimum":0,"maximum":9}},"example":{"municipalTaxRatePercent":7}},"china":{"type":"object","description":"Employee social and housing fund rate.","additionalProperties":false,"properties":{"employeeSocialHousingRatePercent":{"type":"number","description":"finite number from 0 to 40. Employee social insurance and housing fund rate.","minimum":0,"maximum":40}},"example":{"employeeSocialHousingRatePercent":18}},"switzerland":{"type":"object","description":"Occupational pension and canton/commune/church tax rates.","additionalProperties":false,"properties":{"occupationalPensionRatePercent":{"type":"number","description":"finite number from 0 to 25. Occupational pension contribution rate.","minimum":0,"maximum":25},"cantonCommuneChurchTaxRatePercent":{"type":"number","description":"finite number from 0 to 30. Combined canton, commune, and church tax estimate.","minimum":0,"maximum":30}},"example":{"occupationalPensionRatePercent":7,"cantonCommuneChurchTaxRatePercent":8}},"unitedArabEmirates":{"type":"object","description":"Employee pension rate.","additionalProperties":false,"properties":{"employeePensionRatePercent":{"type":"number","description":"finite number from 0 to 20. Optional employee pension or social-security rate.","minimum":0,"maximum":20}},"example":{"employeePensionRatePercent":5}},"qatar":{"type":"object","description":"Employee social-insurance rate.","additionalProperties":false,"properties":{"employeeSocialInsuranceRatePercent":{"type":"number","description":"finite number from 0 to 7. Optional employee social-insurance rate.","minimum":0,"maximum":7}},"example":{"employeeSocialInsuranceRatePercent":5}},"singapore":{"type":"object","description":"Tax residency, CPF profile, and CPF age band.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Income-tax residency.","enum":["resident","nonResident"]},"cpfProfile":{"type":"string","description":"one of: citizenOrSprThirdYear, noCpf. CPF contribution profile.","enum":["citizenOrSprThirdYear","noCpf"]},"cpfAgeBand":{"type":"string","description":"one of: upTo55, age55To60, age60To65, age65To70, above70. CPF age band.","enum":["upTo55","age55To60","age60To65","age65To70","above70"]}},"example":{"taxResidency":"resident","cpfProfile":"citizenOrSprThirdYear","cpfAgeBand":"upTo55"}},"tanzania":{"type":"object","description":"Employment status and retirement scheme.","additionalProperties":false,"properties":{"employmentStatus":{"type":"string","description":"one of: residentPrimary, residentSecondary, nonResident. PAYE employment/residency status.","enum":["residentPrimary","residentSecondary","nonResident"]},"retirementScheme":{"type":"string","description":"one of: nssfStandard, nssfFivePercent, psssf, none. Retirement contribution scheme.","enum":["nssfStandard","nssfFivePercent","psssf","none"]}},"example":{"employmentStatus":"residentPrimary","retirementScheme":"nssfStandard"}},"sudan":{"type":"object","description":"Tax residency and statutory contribution status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Employment tax residency.","enum":["resident","nonResident"]},"statutoryContributionStatus":{"type":"string","description":"one of: formalSector, pensionOnly, notContributing. Pension/health contribution mode.","enum":["formalSector","pensionOnly","notContributing"]}},"example":{"taxResidency":"resident","statutoryContributionStatus":"formalSector"}},"peru":{"type":"object","description":"Tax residency and pension system.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: domiciled, nonDomiciled. Tax residency.","enum":["domiciled","nonDomiciled"]},"pensionSystem":{"type":"string","description":"one of: afpMixed, afpHabitatFlow, afpIntegraFlow, afpPrimaFlow, afpProfuturoFlow, onp, none. Pension system.","enum":["afpMixed","afpHabitatFlow","afpIntegraFlow","afpPrimaFlow","afpProfuturoFlow","onp","none"]}},"example":{"taxResidency":"domiciled","pensionSystem":"onp"}},"bolivia":{"type":"object","description":"Social contribution status and VAT invoice credit.","additionalProperties":false,"properties":{"socialContributionStatus":{"type":"string","description":"one of: contributing, employee65Plus, notContributing. Pension contribution mode.","enum":["contributing","employee65Plus","notContributing"]},"vatInvoiceCreditAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual VAT invoice credit.","minimum":0,"maximum":1000000000000}},"example":{"socialContributionStatus":"contributing","vatInvoiceCreditAnnual":12000}},"coteDIvoire":{"type":"object","description":"Family parts for RICF reduction.","additionalProperties":false,"properties":{"familyParts":{"type":"string","description":"one of: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5. Family parts.","enum":["1","1.5","2","2.5","3","3.5","4","4.5","5"]}},"example":{"familyParts":"1"}},"cambodia":{"type":"object","description":"Tax residency, spouse/dependents count, and NSSF pension status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Salary tax residency.","enum":["resident","nonResident"]},"dependentsAndSpouse":{"type":"integer","description":"integer from 0 to 20. Dependents and spouse count.","minimum":0,"maximum":20},"nssfPensionStatus":{"type":"string","description":"one of: participating, notParticipating. NSSF pension participation.","enum":["participating","notParticipating"]}},"example":{"taxResidency":"resident","dependentsAndSpouse":1,"nssfPensionStatus":"participating"}},"northKorea":{"type":"object","description":"Worker profile and foreign income-tax rate.","additionalProperties":false,"properties":{"workerProfile":{"type":"string","description":"one of: domesticCitizen, foreignIndividual, foreignResident. Worker profile.","enum":["domesticCitizen","foreignIndividual","foreignResident"]},"foreignIncomeTaxRatePercent":{"type":"number","description":"finite number from 5 to 30. Foreign individual income-tax rate.","minimum":5,"maximum":30}},"example":{"workerProfile":"domesticCitizen"}},"nepal":{"type":"object","description":"Tax profile, SSF, insurance deductions, remote-area category, and credits.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: residentSingle, residentCouple, nonResident. Salary tax profile.","enum":["residentSingle","residentCouple","nonResident"]},"ssfContributionStatus":{"type":"string","description":"one of: ssfContributor, notContributing. SSF participation.","enum":["ssfContributor","notContributing"]},"ssfBasicSalaryPercent":{"type":"number","description":"finite number from 0 to 100. SSF basic salary percentage.","minimum":0,"maximum":100},"lifeInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 40,000. Annual life-insurance premium.","minimum":0,"maximum":40000},"healthInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 20,000. Annual health-insurance premium.","minimum":0,"maximum":20000},"buildingInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 5,000. Annual building-insurance premium.","minimum":0,"maximum":5000},"remoteAreaCategory":{"type":"string","description":"one of: none, A, B, C, D, E. Remote-area deduction category.","enum":["none","A","B","C","D","E"]},"femaleTaxCreditStatus":{"type":"string","description":"one of: notClaimed, singleFemaleEmploymentIncome. Female employment-income credit status.","enum":["notClaimed","singleFemaleEmploymentIncome"]},"medicalExpenseAnnual":{"type":"number","description":"finite number from 0 to 10,000. Annual medical expense.","minimum":0,"maximum":10000}},"example":{"taxProfile":"residentSingle","ssfContributionStatus":"ssfContributor","remoteAreaCategory":"none"}},"myanmar":{"type":"object","description":"Tax profile, SSB status, spouse allowance, children, parents, insurance, and savings fund.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: resident, nonResidentForeign, nonResidentCitizenAbroad. Salary tax profile.","enum":["resident","nonResidentForeign","nonResidentCitizenAbroad"]},"ssbContributionStatus":{"type":"string","description":"one of: ssbContributor, notContributing. SSB contribution status.","enum":["ssbContributor","notContributing"]},"spouseAllowance":{"type":"string","description":"one of: notClaimed, claimed. Spouse allowance status.","enum":["notClaimed","claimed"]},"children":{"type":"integer","description":"integer from 0 to 10. Child count.","minimum":0,"maximum":10},"dependentParents":{"type":"integer","description":"integer from 0 to 4. Dependent parents count.","minimum":0,"maximum":4},"lifeInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual life-insurance premium.","minimum":0,"maximum":1000000000000},"savingsFundContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual savings-fund contribution.","minimum":0,"maximum":1000000000000}},"example":{"taxProfile":"resident","ssbContributionStatus":"ssbContributor","spouseAllowance":"notClaimed"}},"moldova":{"type":"object","description":"Personal/spouse allowances, dependents, and health-insurance status.","additionalProperties":false,"properties":{"personalAllowance":{"type":"string","description":"one of: standard, major, notClaimed. Personal allowance status.","enum":["standard","major","notClaimed"]},"spouseAllowance":{"type":"string","description":"one of: notClaimed, majorSpouse. Spouse allowance status.","enum":["notClaimed","majorSpouse"]},"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"severeDisabilityDependents":{"type":"integer","description":"integer from 0 to 20. Severe-disability dependent count.","minimum":0,"maximum":20},"healthInsuranceStatus":{"type":"string","description":"one of: contributing, notContributing. Health-insurance contribution status.","enum":["contributing","notContributing"]}},"example":{"personalAllowance":"standard","spouseAllowance":"notClaimed","dependents":1}},"madagascar":{"type":"object","description":"Social contribution status, dependents, and monthly contribution cap.","additionalProperties":false,"properties":{"socialContributionStatus":{"type":"string","description":"one of: cnapsAndHealth, cnapsOnly, notContributing. Social contribution mode.","enum":["cnapsAndHealth","cnapsOnly","notContributing"]},"dependents":{"type":"integer","description":"integer from 0 to 50. Dependent count.","minimum":0,"maximum":50},"monthlyContributionCap":{"type":"number","description":"finite number from 1 to 100,000,000. Monthly contribution cap.","minimum":1,"maximum":100000000}},"example":{"socialContributionStatus":"cnapsAndHealth","dependents":1}},"kenya":{"type":"object","description":"Tax residency, NSSF mode, pension, insurance, medical fund, and mortgage interest.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. PAYE tax residency.","enum":["resident","nonResident"]},"nssfContributionStatus":{"type":"string","description":"one of: tierIAndII, notContributing. NSSF contribution status.","enum":["tierIAndII","notContributing"]},"additionalPensionContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual additional pension contribution.","minimum":0,"maximum":1000000000000},"insurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 400,000. Annual insurance premium.","minimum":0,"maximum":400000},"postRetirementMedicalFundAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual post-retirement medical fund contribution.","minimum":0,"maximum":1000000000000},"mortgageInterestAnnual":{"type":"number","description":"finite number from 0 to 360,000. Annual mortgage interest.","minimum":0,"maximum":360000}},"example":{"taxResidency":"resident","nssfContributionStatus":"tierIAndII"}},"uzbekistan":{"type":"object","description":"Tax residency and INPS participation.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Tax residency.","enum":["resident","nonResident"]},"inpsParticipation":{"type":"string","description":"one of: participant, notParticipating. INPS participation.","enum":["participant","notParticipating"]}},"example":{"taxResidency":"resident","inpsParticipation":"participant"}},"yemen":{"type":"object","description":"Tax residency and social-insurance status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Salary tax residency.","enum":["resident","nonResident"]},"socialInsuranceStatus":{"type":"string","description":"one of: insured, notInsured. Social-insurance status.","enum":["insured","notInsured"]}},"example":{"taxResidency":"resident","socialInsuranceStatus":"insured"}},"germany":{"type":"object","description":"Health add-on, care status, and church tax rate.","additionalProperties":false,"properties":{"healthAdditionalRatePercent":{"type":"number","description":"finite number from 0 to 6. Additional statutory health-insurance rate.","minimum":0,"maximum":6},"careStatus":{"type":"string","description":"one of: withChildren, childless. Long-term care insurance status.","enum":["withChildren","childless"]},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 9. Optional church tax rate.","minimum":0,"maximum":9}},"example":{"healthAdditionalRatePercent":1.7,"careStatus":"withChildren","churchTaxRatePercent":0}}},"oneOf":[{"required":["annualSalary"]},{"required":["monthlySalary"]},{"required":["salary"]}]},"example":{"annualSalary":120000,"country":"CA","options":{"canada":{"province":"ON","annualPreTaxDeductions":0}}}}}},"responses":{"200":{"description":"Net salary calculation result.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["result","quota"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["country","currency","input","gross","net","deductions","workSchedule","assumptions"],"properties":{"country":{"type":"string"},"currency":{"type":"string","minLength":3,"maxLength":3},"input":{"type":"object","additionalProperties":false,"required":["salary","salaryPeriod","annualGross"],"properties":{"salary":{"type":"number","minimum":0},"salaryPeriod":{"type":"string","enum":["annual","monthly"]},"annualGross":{"type":"number","minimum":0}}},"gross":{"type":"object","additionalProperties":false,"required":["annual","monthly","hourly"],"properties":{"annual":{"type":"number","minimum":0},"monthly":{"type":"number","minimum":0},"hourly":{"type":"number","minimum":0}}},"net":{"type":"object","additionalProperties":false,"required":["annual","monthly","hourly"],"properties":{"annual":{"type":"number","minimum":0},"monthly":{"type":"number","minimum":0},"hourly":{"type":"number","minimum":0}}},"deductions":{"type":"object","additionalProperties":false,"required":["annual","monthly","effectiveRate","lines"],"properties":{"annual":{"type":"number","minimum":0},"monthly":{"type":"number","minimum":0},"effectiveRate":{"type":"number","minimum":0,"maximum":1},"lines":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","label","amount","detail"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"amount":{"type":"number"},"detail":{"type":"string"}}}}}},"workSchedule":{"type":"object","additionalProperties":false,"required":["hoursPerDay","daysPerWeek","annualHours"],"properties":{"hoursPerDay":{"type":"integer","enum":[8]},"daysPerWeek":{"type":"integer","enum":[5]},"annualHours":{"type":"integer","enum":[2080]}}},"assumptions":{"type":"array","items":{"type":"string"}}}},"quota":{"type":"object","additionalProperties":false,"required":["allowed","limit","used","remaining","resetAt"],"properties":{"allowed":{"type":"boolean"},"limit":{"type":"integer","minimum":0},"used":{"type":"integer","minimum":0},"remaining":{"type":"integer","minimum":0},"resetAt":{"type":"string","format":"date-time"}}}}},"example":{"result":{"country":"CA","currency":"CAD","input":{"salary":120000,"salaryPeriod":"annual","annualGross":120000},"gross":{"annual":120000,"monthly":10000,"hourly":57.69},"net":{"annual":89120,"monthly":7426.67,"hourly":42.85},"deductions":{"annual":30880,"monthly":2573.33,"effectiveRate":0.2573,"lines":[{"id":"federal-income-tax","label":"Federal income tax","amount":16500,"detail":"Estimated federal income tax."}]},"workSchedule":{"hoursPerDay":8,"daysPerWeek":5,"annualHours":2080},"assumptions":["Estimate based on standard tax and payroll deduction rules for the selected country."]},"quota":{"allowed":true,"limit":3000,"used":15,"remaining":2985,"resetAt":"2026-07-25T12:00:00.000Z"}}}}},"400":{"description":"Invalid net salary calculation payload.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"401":{"description":"Missing or invalid Bearer API key.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"403":{"description":"API access is not allowed for this account or key.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"413":{"description":"Request body is too large.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"415":{"description":"Request body must be JSON.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"429":{"description":"Account quota or short-window API rate limit exceeded.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"500":{"description":"Unexpected server error.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}},"503":{"description":"Request processing is temporarily unavailable.","headers":{"X-Quota-Limit":{"description":"Current account quota limit, or the key-specific cap on an api_key_quota_exceeded response.","schema":{"type":"integer","minimum":0}},"X-Quota-Used":{"description":"Counted lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Remaining":{"description":"Remaining lookups for the quota scope represented by this response.","schema":{"type":"integer","minimum":0}},"X-Quota-Reset":{"description":"ISO timestamp when the represented account or key quota window resets.","schema":{"type":"string","format":"date-time"}},"X-RateLimit-Limit":{"description":"Account rate limit, or the key-specific cap on an api_key_rate_limit_exceeded response.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Used":{"description":"Used requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Remaining":{"description":"Remaining requests in the current short rate-limit window.","schema":{"type":"integer","minimum":0}},"X-RateLimit-Reset":{"description":"ISO timestamp when the short rate-limit window resets.","schema":{"type":"string","format":"date-time"}},"X-Request-ID":{"description":"Request ID for support and debugging.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Bearer authentication challenge for an invalid or missing API key.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a limited request.","schema":{"type":"integer","minimum":0}},"Allow":{"description":"Methods supported by the requested endpoint.","schema":{"type":"string"}},"Link":{"description":"Canonical endpoint link for compatibility aliases.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"SalaryAPI API key"}},"schemas":{"SalaryBenchmarkRequest":{"type":"object","additionalProperties":false,"required":["jobTitle"],"properties":{"jobTitle":{"type":"string","minLength":2,"maxLength":80,"description":"Real job title or paid work role to benchmark."},"location":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string","maxLength":80},"state":{"type":"string","maxLength":80},"city":{"type":"string","maxLength":80}}},"currency":{"type":"string","minLength":3,"maxLength":3,"enum":["USD","EUR","GBP","JPY","CAD","AUD","CHF","CNY","HKD","SGD","NZD","SEK","NOK","DKK","PLN","CZK","HUF","RON","TRY","UAH","RUB","ILS","AED","SAR","QAR","KWD","BHD","OMR","JOD","INR","PKR","BDT","LKR","IDR","THB","MYR","PHP","VND","KRW","TWD","MXN","BRL","CLP","COP","PEN","ARS","ZAR","EGP","NGN","KES","GHS","TND","MAD","AFN","BOB","CDF","CUP","DZD","ETB","IQD","IRR","KHR","MDL","MGA","MMK","NPR","RSD","SDG","TZS","UZS","XOF","YER"],"default":"USD","description":"Supported 3-letter currency code for the response values."},"seniority":{"type":"string","maxLength":40,"default":"any"}}},"SalaryBenchmarkResponse":{"type":"object","additionalProperties":false,"required":["result","quota"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["found","jobTitle","seniority","currency","salaryPeriod","annualBaseSalary","variableCompensation","hourlyEquivalent"],"properties":{"found":{"type":"boolean"},"jobTitle":{"type":"string"},"seniority":{"type":"string"},"currency":{"type":"string","minLength":3,"maxLength":3},"salaryPeriod":{"type":"string","enum":["annual"]},"annualBaseSalary":{"oneOf":[{"type":"object","additionalProperties":false,"required":["p10","p25","median","p75","p90"],"properties":{"p10":{"type":"number","minimum":0},"p25":{"type":"number","minimum":0},"median":{"type":"number","minimum":0},"p75":{"type":"number","minimum":0},"p90":{"type":"number","minimum":0}}},{"type":"null"}]},"variableCompensation":{"oneOf":[{"type":"object","additionalProperties":false,"required":["type","typicalPercentOfBase","percentRange"],"properties":{"type":{"type":"string","enum":["bonus","commission","tips","profit_sharing","mixed","other"]},"typicalPercentOfBase":{"oneOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"null"}]},"percentRange":{"oneOf":[{"type":"object","additionalProperties":false,"required":["p25","median","p75"],"properties":{"p25":{"type":"number","minimum":0,"maximum":1000},"median":{"type":"number","minimum":0,"maximum":1000},"p75":{"type":"number","minimum":0,"maximum":1000}}},{"type":"null"}]}}},{"type":"null"}]},"hourlyEquivalent":{"oneOf":[{"type":"object","additionalProperties":false,"required":["median"],"properties":{"median":{"type":"number","minimum":0}}},{"type":"null"}]}}},"quota":{"type":"object","additionalProperties":false,"required":["allowed","limit","used","remaining","resetAt"],"properties":{"allowed":{"type":"boolean"},"limit":{"type":"integer","minimum":0},"used":{"type":"integer","minimum":0},"remaining":{"type":"integer","minimum":0},"resetAt":{"type":"string","format":"date-time"}}}}},"NetSalaryRequest":{"type":"object","additionalProperties":false,"required":["country"],"properties":{"country":{"type":"string","minLength":2,"maxLength":80,"description":"Supported country code or English country label.","examples":["US","United States","BG","Bulgaria"]},"annualSalary":{"type":"number","minimum":0,"maximum":1000000000000,"description":"Gross annual salary before tax, expressed in the calculator currency for the selected country. Send exactly one salary input."},"monthlySalary":{"type":"number","minimum":0,"maximum":83333333333.33333,"description":"Gross monthly salary before tax, expressed in the calculator currency for the selected country. Send exactly one salary input."},"salary":{"type":"number","minimum":0,"maximum":1000000000000,"description":"Generic gross salary amount in the calculator currency for the selected country. Use salaryPeriod or period to send monthly salary; defaults to annual when omitted."},"salaryPeriod":{"type":"string","enum":["annual","monthly"],"description":"Optional period for the generic salary field. Defaults to annual when omitted."},"period":{"type":"string","enum":["annual","monthly"],"description":"Alias for salaryPeriod. If both are sent, they must match."},"options":{"type":"object","additionalProperties":false,"properties":{"us":{"type":"object","description":"Federal filing status, pre-tax deductions, and optional flat state/local estimate.","additionalProperties":false,"properties":{"filingStatus":{"type":"string","description":"one of: single, marriedJoint, headOfHousehold. Federal filing status used for brackets and standard deduction.","enum":["single","marriedJoint","headOfHousehold"]},"annualPreTaxDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pre-tax deductions subtracted before income tax where supported by the calculator.","minimum":0,"maximum":1000000000000},"stateLocalTaxRatePercent":{"type":"number","description":"finite number from 0 to 20. Optional flat state/local income-tax estimate.","minimum":0,"maximum":20}},"example":{"filingStatus":"single","annualPreTaxDeductions":12000,"stateLocalTaxRatePercent":5}},"unitedKingdom":{"type":"object","description":"Tax region and optional pension contribution settings.","additionalProperties":false,"properties":{"taxRegion":{"type":"string","description":"one of: englandWalesNorthernIreland, scotland. Income-tax region.","enum":["englandWalesNorthernIreland","scotland"]},"pensionContributionRatePercent":{"type":"number","description":"finite number from 0 to 100. Employee pension contribution rate.","minimum":0,"maximum":100},"pensionContributionBasis":{"type":"string","description":"one of: qualifyingEarnings, grossPay. Pay basis used for pension contribution.","enum":["qualifyingEarnings","grossPay"]},"pensionReliefMethod":{"type":"string","description":"one of: netPay, reliefAtSource. Pension tax-relief method.","enum":["netPay","reliefAtSource"]}},"example":{"taxRegion":"englandWalesNorthernIreland","pensionContributionRatePercent":5,"pensionContributionBasis":"grossPay","pensionReliefMethod":"netPay"}},"denmark":{"type":"object","description":"Municipal and church tax overrides.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 35. Municipal tax rate override.","minimum":0,"maximum":35},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 2. Optional church tax rate.","minimum":0,"maximum":2}},"example":{"municipalTaxRatePercent":25.1,"churchTaxRatePercent":0.7}},"japan":{"type":"object","description":"Health insurance, care insurance, and resident tax settings.","additionalProperties":false,"properties":{"healthInsuranceRatePercent":{"type":"number","description":"finite number from 0 to 8. Employee health-insurance rate override.","minimum":0,"maximum":8},"careInsuranceStatus":{"type":"string","description":"one of: notApplicable, age40To64. Care-insurance applicability.","enum":["notApplicable","age40To64"]},"residentTaxRatePercent":{"type":"number","description":"finite number from 0 to 15. Resident tax rate override.","minimum":0,"maximum":15}},"example":{"careInsuranceStatus":"age40To64","residentTaxRatePercent":10}},"malta":{"type":"object","description":"Resident tax status and social-security age band.","additionalProperties":false,"properties":{"taxStatus":{"type":"string","description":"one of: single, married, marriedOneChild, marriedTwoOrMoreChildren, parent, parentOneChild, parentTwoOrMoreChildren. Resident income-tax status.","enum":["single","married","marriedOneChild","marriedTwoOrMoreChildren","parent","parentOneChild","parentTwoOrMoreChildren"]},"socialSecurityAgeBand":{"type":"string","description":"one of: born1962OrLater, bornUpTo1961. Class 1 social-security age band.","enum":["born1962OrLater","bornUpTo1961"]}},"example":{"taxStatus":"single","socialSecurityAgeBand":"born1962OrLater"}},"newZealand":{"type":"object","description":"KiwiSaver and student-loan deduction rates.","additionalProperties":false,"properties":{"kiwiSaverRatePercent":{"type":"number","description":"finite number from 0 to 10. KiwiSaver employee contribution rate.","minimum":0,"maximum":10},"studentLoanRatePercent":{"type":"number","description":"finite number from 0 to 12. Student-loan repayment rate.","minimum":0,"maximum":12}},"example":{"kiwiSaverRatePercent":3,"studentLoanRatePercent":12}},"australia":{"type":"object","description":"HELP/STSL study-loan repayment status.","additionalProperties":false,"properties":{"studyLoanStatus":{"type":"string","description":"one of: none, studyLoan. Study-loan repayment mode.","enum":["none","studyLoan"]}},"example":{"studyLoanStatus":"studyLoan"}},"france":{"type":"object","description":"Household tax parts for income-tax estimate.","additionalProperties":false,"properties":{"taxParts":{"type":"number","description":"finite number from 1 to 10. French household tax parts.","minimum":1,"maximum":10}},"example":{"taxParts":1}},"israel":{"type":"object","description":"Tax credit points and employee pension rate.","additionalProperties":false,"properties":{"taxCreditPoints":{"type":"number","description":"finite number from 0 to 20. Income-tax credit points.","minimum":0,"maximum":20},"pensionRatePercent":{"type":"number","description":"finite number from 0 to 20. Employee pension contribution rate.","minimum":0,"maximum":20}},"example":{"taxCreditPoints":2.25,"pensionRatePercent":6}},"italy":{"type":"object","description":"Employee social-security and local surtax rates.","additionalProperties":false,"properties":{"employeeSocialSecurityRatePercent":{"type":"number","description":"finite number from 0 to 15. Employee social-security contribution rate override.","minimum":0,"maximum":15},"regionalTaxRatePercent":{"type":"number","description":"finite number from 0 to 3.33. Regional surtax rate.","minimum":0,"maximum":3.33},"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 0.9. Municipal surtax rate.","minimum":0,"maximum":0.9}},"example":{"employeeSocialSecurityRatePercent":9.19,"regionalTaxRatePercent":1.23,"municipalTaxRatePercent":0.8}},"ireland":{"type":"object","description":"PAYE profile, USC, PRSI period, partner income, pension, and extra credits.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: single, singleParent, marriedOneIncome, marriedTwoIncomes. PAYE tax profile.","enum":["single","singleParent","marriedOneIncome","marriedTwoIncomes"]},"uscStatus":{"type":"string","description":"one of: standard, reduced. USC rate profile.","enum":["standard","reduced"]},"prsiPeriod":{"type":"string","description":"one of: fullYear2026, beforeOctober2026, fromOctober2026. PRSI period rate.","enum":["fullYear2026","beforeOctober2026","fromOctober2026"]},"partnerIncomeAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual partner income for married two-income calculations.","minimum":0,"maximum":1000000000000},"pensionContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pension contribution.","minimum":0,"maximum":1000000000000},"additionalTaxCreditsAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Additional annual tax credits.","minimum":0,"maximum":1000000000000}},"example":{"taxProfile":"single","uscStatus":"standard","pensionContributionAnnual":3000}},"finland":{"type":"object","description":"Municipal/church tax and public broadcasting tax switch.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 12. Municipal income-tax rate.","minimum":0,"maximum":12},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 2.25. Optional church tax rate.","minimum":0,"maximum":2.25},"includePublicBroadcastingTax":{"type":"boolean","description":"true or false. Whether to include public broadcasting tax."}},"example":{"municipalTaxRatePercent":7.5,"includePublicBroadcastingTax":true}},"czechia":{"type":"object","description":"Taxpayer credit and social/health insurance profile.","additionalProperties":false,"properties":{"taxpayerCredit":{"type":"string","description":"one of: claimed, notClaimed. Basic taxpayer credit treatment.","enum":["claimed","notClaimed"]},"socialInsuranceProfile":{"type":"string","description":"one of: standard, workingPensionerDiscount, notInsured. Social-insurance mode.","enum":["standard","workingPensionerDiscount","notInsured"]},"healthMinimumBase":{"type":"string","description":"one of: standard, exempt. Health-insurance minimum-base treatment.","enum":["standard","exempt"]}},"example":{"taxpayerCredit":"claimed","socialInsuranceProfile":"standard"}},"cuba":{"type":"object","description":"Special social-security contribution status.","additionalProperties":false,"properties":{"socialSecurityStatus":{"type":"string","description":"one of: standard, notContributing. Social-security contribution mode.","enum":["standard","notContributing"]}},"example":{"socialSecurityStatus":"standard"}},"hungary":{"type":"object","description":"Allowance eligibility, PIT exemption profile, children counts, and first-marriage months.","additionalProperties":false,"properties":{"allowanceEligibility":{"type":"string","description":"one of: eligible, notEligible. Tax-base allowance eligibility.","enum":["eligible","notEligible"]},"pitExemptionProfile":{"type":"string","description":"one of: none, under25, motherUnder30, motherTwoChildrenUnder40, motherThreeOrMoreChildren, motherFourOrMoreChildren. Selected PIT exemption profile.","enum":["none","under25","motherUnder30","motherTwoChildrenUnder40","motherThreeOrMoreChildren","motherFourOrMoreChildren"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 100. Dependent children count.","minimum":0,"maximum":100},"disabledDependentChildren":{"type":"integer","description":"integer from 0 to 100. Disabled dependent children count.","minimum":0,"maximum":100},"severeDisabilityPersonalAllowance":{"type":"boolean","description":"true or false. Whether to apply severe-disability personal allowance."},"firstMarriageMonths":{"type":"integer","description":"integer from 0 to 12. Months eligible for first-marriage allowance in the estimated tax year.","minimum":0,"maximum":12}},"example":{"allowanceEligibility":"eligible","pitExemptionProfile":"none","dependentChildren":1}},"iran":{"type":"object","description":"Employee social-insurance status.","additionalProperties":false,"properties":{"socialInsuranceStatus":{"type":"string","description":"one of: insuredCapped, notInsured. Social-insurance mode.","enum":["insuredCapped","notInsured"]}},"example":{"socialInsuranceStatus":"insuredCapped"}},"iraq":{"type":"object","description":"Tax profile, social-security mode, dependents, age flag, and risk allowance.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: bachelor, married. Personal allowance profile.","enum":["bachelor","married"]},"socialSecurityStatus":{"type":"string","description":"one of: insuredCapped, notInsured. Social-security mode.","enum":["insuredCapped","notInsured"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 100. Dependent children count.","minimum":0,"maximum":100},"over63":{"type":"boolean","description":"true or false. Whether the taxpayer is over 63."},"riskAllowancePercent":{"type":"number","description":"finite number from 0 to 30. Optional risk allowance percentage.","minimum":0,"maximum":30}},"example":{"taxProfile":"married","socialSecurityStatus":"insuredCapped","dependentChildren":2}},"mexico":{"type":"object","description":"IMSS wage-base factor.","additionalProperties":false,"properties":{"imssWageBaseFactor":{"type":"number","description":"finite number from 0.01 to 2. IMSS wage-base factor.","minimum":0.01,"maximum":2}},"example":{"imssWageBaseFactor":1}},"egypt":{"type":"object","description":"Social-insurance wage factor.","additionalProperties":false,"properties":{"socialInsuranceWageFactor":{"type":"number","description":"finite number from 0.01 to 2. Social-insurance wage factor.","minimum":0.01,"maximum":2}},"example":{"socialInsuranceWageFactor":1}},"afghanistan":{"type":"object","description":"Public/private pension profile.","additionalProperties":false,"properties":{"pensionProfile":{"type":"string","description":"one of: privateSector, civilService, securityForces. Pension deduction profile.","enum":["privateSector","civilService","securityForces"]}},"example":{"pensionProfile":"privateSector"}},"greece":{"type":"object","description":"Age band and dependent children.","additionalProperties":false,"properties":{"ageBand":{"type":"string","description":"one of: standard, upTo25, age26To30. Worker age band.","enum":["standard","upTo25","age26To30"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 12. Dependent children count.","minimum":0,"maximum":12}},"example":{"ageBand":"standard","dependentChildren":1}},"india":{"type":"object","description":"EPF wage factor/cap and professional tax.","additionalProperties":false,"properties":{"epfWageFactor":{"type":"number","description":"finite number from 0 to 1. EPF wage factor.","minimum":0,"maximum":1},"epfMonthlyWageCap":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. EPF monthly wage cap.","minimum":0,"maximum":1000000000000},"professionalTaxAnnual":{"type":"number","description":"finite number from 0 to 2,500. Annual professional tax.","minimum":0,"maximum":2500}},"example":{"epfWageFactor":1,"professionalTaxAnnual":2500}},"sweden":{"type":"object","description":"Municipal income-tax rate.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 40. Municipal income-tax rate.","minimum":0,"maximum":40}},"example":{"municipalTaxRatePercent":32}},"brazil":{"type":"object","description":"Dependent count and other monthly deductions.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"otherMonthlyDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Other monthly deductions.","minimum":0,"maximum":1000000000000}},"example":{"dependents":1,"otherMonthlyDeductions":500}},"argentina":{"type":"object","description":"Spouse deduction and child count.","additionalProperties":false,"properties":{"spouseDeduction":{"type":"string","description":"one of: notClaimed, claimed. Spouse deduction status.","enum":["notClaimed","claimed"]},"children":{"type":"integer","description":"integer from 0 to 10. Child count.","minimum":0,"maximum":10}},"example":{"spouseDeduction":"notClaimed","children":1}},"romania":{"type":"object","description":"Dependents, enrolled children, young-employee status, and minimum-wage relief mode.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"enrolledChildren":{"type":"integer","description":"integer from 0 to 20. Enrolled children count.","minimum":0,"maximum":20},"youngEmployeeStatus":{"type":"string","description":"one of: standard, under26. Young employee treatment.","enum":["standard","under26"]},"minimumWageReliefStatus":{"type":"string","description":"one of: auto, off. Minimum-wage relief treatment.","enum":["auto","off"]}},"example":{"dependents":1,"minimumWageReliefStatus":"auto"}},"portugal":{"type":"object","description":"Tax situation, dependents, and pay periods.","additionalProperties":false,"properties":{"taxSituation":{"type":"string","description":"one of: singleNoDependentsOrMarriedTwoEarners, singleWithDependents, marriedSingleEarner. IRS withholding situation.","enum":["singleNoDependentsOrMarriedTwoEarners","singleWithDependents","marriedSingleEarner"]},"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"payPeriods":{"type":"integer","description":"one of: 12, 14. Number of annual salary payment periods.","enum":[12,14]}},"example":{"taxSituation":"singleNoDependentsOrMarriedTwoEarners","payPeriods":14}},"spain":{"type":"object","description":"Regional income-tax rate override.","additionalProperties":false,"properties":{"regionalTaxRatePercent":{"type":"number","description":"finite number from 0 to 10. Regional IRPF rate adjustment.","minimum":0,"maximum":10}},"example":{"regionalTaxRatePercent":9.5}},"democraticRepublicOfTheCongo":{"type":"object","description":"Dependent count.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 9. Dependent count.","minimum":0,"maximum":9}},"example":{"dependents":2}},"indonesia":{"type":"object","description":"Tax status and dependent count.","additionalProperties":false,"properties":{"taxStatus":{"type":"string","description":"one of: single, married. PTKP tax status.","enum":["single","married"]},"dependents":{"type":"integer","description":"integer from 0 to 3. Dependent count.","minimum":0,"maximum":3}},"example":{"taxStatus":"single","dependents":1}},"netherlands":{"type":"object","description":"Payroll tax credit and employee pension rate.","additionalProperties":false,"properties":{"payrollTaxCredit":{"type":"string","description":"one of: applied, notApplied. Payroll tax credit treatment.","enum":["applied","notApplied"]},"employeePensionRatePercent":{"type":"number","description":"finite number from 0 to 30. Employee pension contribution rate.","minimum":0,"maximum":30}},"example":{"payrollTaxCredit":"applied","employeePensionRatePercent":5}},"bangladesh":{"type":"object","description":"Taxpayer category and allowable investments.","additionalProperties":false,"properties":{"taxpayerCategory":{"type":"string","description":"one of: general, womanOrSenior, disabledOrThirdGender, warWoundedFreedomFighter. Taxpayer threshold category.","enum":["general","womanOrSenior","disabledOrThirdGender","warWoundedFreedomFighter"]},"allowableInvestmentsAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual allowable investments for rebate estimate.","minimum":0,"maximum":1000000000000}},"example":{"taxpayerCategory":"general","allowableInvestmentsAnnual":100000}},"canada":{"type":"object","description":"Province selection and annual pre-tax deductions.","additionalProperties":false,"properties":{"province":{"type":"string","description":"one of: ON, BC, AB. Province used for province income tax.","enum":["ON","BC","AB"]},"annualPreTaxDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pre-tax deductions.","minimum":0,"maximum":1000000000000}},"example":{"province":"ON","annualPreTaxDeductions":0}},"belgium":{"type":"object","description":"Municipal tax rate.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 9. Municipal tax rate.","minimum":0,"maximum":9}},"example":{"municipalTaxRatePercent":7}},"china":{"type":"object","description":"Employee social and housing fund rate.","additionalProperties":false,"properties":{"employeeSocialHousingRatePercent":{"type":"number","description":"finite number from 0 to 40. Employee social insurance and housing fund rate.","minimum":0,"maximum":40}},"example":{"employeeSocialHousingRatePercent":18}},"switzerland":{"type":"object","description":"Occupational pension and canton/commune/church tax rates.","additionalProperties":false,"properties":{"occupationalPensionRatePercent":{"type":"number","description":"finite number from 0 to 25. Occupational pension contribution rate.","minimum":0,"maximum":25},"cantonCommuneChurchTaxRatePercent":{"type":"number","description":"finite number from 0 to 30. Combined canton, commune, and church tax estimate.","minimum":0,"maximum":30}},"example":{"occupationalPensionRatePercent":7,"cantonCommuneChurchTaxRatePercent":8}},"unitedArabEmirates":{"type":"object","description":"Employee pension rate.","additionalProperties":false,"properties":{"employeePensionRatePercent":{"type":"number","description":"finite number from 0 to 20. Optional employee pension or social-security rate.","minimum":0,"maximum":20}},"example":{"employeePensionRatePercent":5}},"qatar":{"type":"object","description":"Employee social-insurance rate.","additionalProperties":false,"properties":{"employeeSocialInsuranceRatePercent":{"type":"number","description":"finite number from 0 to 7. Optional employee social-insurance rate.","minimum":0,"maximum":7}},"example":{"employeeSocialInsuranceRatePercent":5}},"singapore":{"type":"object","description":"Tax residency, CPF profile, and CPF age band.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Income-tax residency.","enum":["resident","nonResident"]},"cpfProfile":{"type":"string","description":"one of: citizenOrSprThirdYear, noCpf. CPF contribution profile.","enum":["citizenOrSprThirdYear","noCpf"]},"cpfAgeBand":{"type":"string","description":"one of: upTo55, age55To60, age60To65, age65To70, above70. CPF age band.","enum":["upTo55","age55To60","age60To65","age65To70","above70"]}},"example":{"taxResidency":"resident","cpfProfile":"citizenOrSprThirdYear","cpfAgeBand":"upTo55"}},"tanzania":{"type":"object","description":"Employment status and retirement scheme.","additionalProperties":false,"properties":{"employmentStatus":{"type":"string","description":"one of: residentPrimary, residentSecondary, nonResident. PAYE employment/residency status.","enum":["residentPrimary","residentSecondary","nonResident"]},"retirementScheme":{"type":"string","description":"one of: nssfStandard, nssfFivePercent, psssf, none. Retirement contribution scheme.","enum":["nssfStandard","nssfFivePercent","psssf","none"]}},"example":{"employmentStatus":"residentPrimary","retirementScheme":"nssfStandard"}},"sudan":{"type":"object","description":"Tax residency and statutory contribution status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Employment tax residency.","enum":["resident","nonResident"]},"statutoryContributionStatus":{"type":"string","description":"one of: formalSector, pensionOnly, notContributing. Pension/health contribution mode.","enum":["formalSector","pensionOnly","notContributing"]}},"example":{"taxResidency":"resident","statutoryContributionStatus":"formalSector"}},"peru":{"type":"object","description":"Tax residency and pension system.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: domiciled, nonDomiciled. Tax residency.","enum":["domiciled","nonDomiciled"]},"pensionSystem":{"type":"string","description":"one of: afpMixed, afpHabitatFlow, afpIntegraFlow, afpPrimaFlow, afpProfuturoFlow, onp, none. Pension system.","enum":["afpMixed","afpHabitatFlow","afpIntegraFlow","afpPrimaFlow","afpProfuturoFlow","onp","none"]}},"example":{"taxResidency":"domiciled","pensionSystem":"onp"}},"bolivia":{"type":"object","description":"Social contribution status and VAT invoice credit.","additionalProperties":false,"properties":{"socialContributionStatus":{"type":"string","description":"one of: contributing, employee65Plus, notContributing. Pension contribution mode.","enum":["contributing","employee65Plus","notContributing"]},"vatInvoiceCreditAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual VAT invoice credit.","minimum":0,"maximum":1000000000000}},"example":{"socialContributionStatus":"contributing","vatInvoiceCreditAnnual":12000}},"coteDIvoire":{"type":"object","description":"Family parts for RICF reduction.","additionalProperties":false,"properties":{"familyParts":{"type":"string","description":"one of: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5. Family parts.","enum":["1","1.5","2","2.5","3","3.5","4","4.5","5"]}},"example":{"familyParts":"1"}},"cambodia":{"type":"object","description":"Tax residency, spouse/dependents count, and NSSF pension status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Salary tax residency.","enum":["resident","nonResident"]},"dependentsAndSpouse":{"type":"integer","description":"integer from 0 to 20. Dependents and spouse count.","minimum":0,"maximum":20},"nssfPensionStatus":{"type":"string","description":"one of: participating, notParticipating. NSSF pension participation.","enum":["participating","notParticipating"]}},"example":{"taxResidency":"resident","dependentsAndSpouse":1,"nssfPensionStatus":"participating"}},"northKorea":{"type":"object","description":"Worker profile and foreign income-tax rate.","additionalProperties":false,"properties":{"workerProfile":{"type":"string","description":"one of: domesticCitizen, foreignIndividual, foreignResident. Worker profile.","enum":["domesticCitizen","foreignIndividual","foreignResident"]},"foreignIncomeTaxRatePercent":{"type":"number","description":"finite number from 5 to 30. Foreign individual income-tax rate.","minimum":5,"maximum":30}},"example":{"workerProfile":"domesticCitizen"}},"nepal":{"type":"object","description":"Tax profile, SSF, insurance deductions, remote-area category, and credits.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: residentSingle, residentCouple, nonResident. Salary tax profile.","enum":["residentSingle","residentCouple","nonResident"]},"ssfContributionStatus":{"type":"string","description":"one of: ssfContributor, notContributing. SSF participation.","enum":["ssfContributor","notContributing"]},"ssfBasicSalaryPercent":{"type":"number","description":"finite number from 0 to 100. SSF basic salary percentage.","minimum":0,"maximum":100},"lifeInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 40,000. Annual life-insurance premium.","minimum":0,"maximum":40000},"healthInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 20,000. Annual health-insurance premium.","minimum":0,"maximum":20000},"buildingInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 5,000. Annual building-insurance premium.","minimum":0,"maximum":5000},"remoteAreaCategory":{"type":"string","description":"one of: none, A, B, C, D, E. Remote-area deduction category.","enum":["none","A","B","C","D","E"]},"femaleTaxCreditStatus":{"type":"string","description":"one of: notClaimed, singleFemaleEmploymentIncome. Female employment-income credit status.","enum":["notClaimed","singleFemaleEmploymentIncome"]},"medicalExpenseAnnual":{"type":"number","description":"finite number from 0 to 10,000. Annual medical expense.","minimum":0,"maximum":10000}},"example":{"taxProfile":"residentSingle","ssfContributionStatus":"ssfContributor","remoteAreaCategory":"none"}},"myanmar":{"type":"object","description":"Tax profile, SSB status, spouse allowance, children, parents, insurance, and savings fund.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: resident, nonResidentForeign, nonResidentCitizenAbroad. Salary tax profile.","enum":["resident","nonResidentForeign","nonResidentCitizenAbroad"]},"ssbContributionStatus":{"type":"string","description":"one of: ssbContributor, notContributing. SSB contribution status.","enum":["ssbContributor","notContributing"]},"spouseAllowance":{"type":"string","description":"one of: notClaimed, claimed. Spouse allowance status.","enum":["notClaimed","claimed"]},"children":{"type":"integer","description":"integer from 0 to 10. Child count.","minimum":0,"maximum":10},"dependentParents":{"type":"integer","description":"integer from 0 to 4. Dependent parents count.","minimum":0,"maximum":4},"lifeInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual life-insurance premium.","minimum":0,"maximum":1000000000000},"savingsFundContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual savings-fund contribution.","minimum":0,"maximum":1000000000000}},"example":{"taxProfile":"resident","ssbContributionStatus":"ssbContributor","spouseAllowance":"notClaimed"}},"moldova":{"type":"object","description":"Personal/spouse allowances, dependents, and health-insurance status.","additionalProperties":false,"properties":{"personalAllowance":{"type":"string","description":"one of: standard, major, notClaimed. Personal allowance status.","enum":["standard","major","notClaimed"]},"spouseAllowance":{"type":"string","description":"one of: notClaimed, majorSpouse. Spouse allowance status.","enum":["notClaimed","majorSpouse"]},"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"severeDisabilityDependents":{"type":"integer","description":"integer from 0 to 20. Severe-disability dependent count.","minimum":0,"maximum":20},"healthInsuranceStatus":{"type":"string","description":"one of: contributing, notContributing. Health-insurance contribution status.","enum":["contributing","notContributing"]}},"example":{"personalAllowance":"standard","spouseAllowance":"notClaimed","dependents":1}},"madagascar":{"type":"object","description":"Social contribution status, dependents, and monthly contribution cap.","additionalProperties":false,"properties":{"socialContributionStatus":{"type":"string","description":"one of: cnapsAndHealth, cnapsOnly, notContributing. Social contribution mode.","enum":["cnapsAndHealth","cnapsOnly","notContributing"]},"dependents":{"type":"integer","description":"integer from 0 to 50. Dependent count.","minimum":0,"maximum":50},"monthlyContributionCap":{"type":"number","description":"finite number from 1 to 100,000,000. Monthly contribution cap.","minimum":1,"maximum":100000000}},"example":{"socialContributionStatus":"cnapsAndHealth","dependents":1}},"kenya":{"type":"object","description":"Tax residency, NSSF mode, pension, insurance, medical fund, and mortgage interest.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. PAYE tax residency.","enum":["resident","nonResident"]},"nssfContributionStatus":{"type":"string","description":"one of: tierIAndII, notContributing. NSSF contribution status.","enum":["tierIAndII","notContributing"]},"additionalPensionContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual additional pension contribution.","minimum":0,"maximum":1000000000000},"insurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 400,000. Annual insurance premium.","minimum":0,"maximum":400000},"postRetirementMedicalFundAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual post-retirement medical fund contribution.","minimum":0,"maximum":1000000000000},"mortgageInterestAnnual":{"type":"number","description":"finite number from 0 to 360,000. Annual mortgage interest.","minimum":0,"maximum":360000}},"example":{"taxResidency":"resident","nssfContributionStatus":"tierIAndII"}},"uzbekistan":{"type":"object","description":"Tax residency and INPS participation.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Tax residency.","enum":["resident","nonResident"]},"inpsParticipation":{"type":"string","description":"one of: participant, notParticipating. INPS participation.","enum":["participant","notParticipating"]}},"example":{"taxResidency":"resident","inpsParticipation":"participant"}},"yemen":{"type":"object","description":"Tax residency and social-insurance status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Salary tax residency.","enum":["resident","nonResident"]},"socialInsuranceStatus":{"type":"string","description":"one of: insured, notInsured. Social-insurance status.","enum":["insured","notInsured"]}},"example":{"taxResidency":"resident","socialInsuranceStatus":"insured"}},"germany":{"type":"object","description":"Health add-on, care status, and church tax rate.","additionalProperties":false,"properties":{"healthAdditionalRatePercent":{"type":"number","description":"finite number from 0 to 6. Additional statutory health-insurance rate.","minimum":0,"maximum":6},"careStatus":{"type":"string","description":"one of: withChildren, childless. Long-term care insurance status.","enum":["withChildren","childless"]},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 9. Optional church tax rate.","minimum":0,"maximum":9}},"example":{"healthAdditionalRatePercent":1.7,"careStatus":"withChildren","churchTaxRatePercent":0}}},"description":"Nested country-specific options. Use this or top-level country option keys, not both."},"us":{"type":"object","description":"Federal filing status, pre-tax deductions, and optional flat state/local estimate.","additionalProperties":false,"properties":{"filingStatus":{"type":"string","description":"one of: single, marriedJoint, headOfHousehold. Federal filing status used for brackets and standard deduction.","enum":["single","marriedJoint","headOfHousehold"]},"annualPreTaxDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pre-tax deductions subtracted before income tax where supported by the calculator.","minimum":0,"maximum":1000000000000},"stateLocalTaxRatePercent":{"type":"number","description":"finite number from 0 to 20. Optional flat state/local income-tax estimate.","minimum":0,"maximum":20}},"example":{"filingStatus":"single","annualPreTaxDeductions":12000,"stateLocalTaxRatePercent":5}},"unitedKingdom":{"type":"object","description":"Tax region and optional pension contribution settings.","additionalProperties":false,"properties":{"taxRegion":{"type":"string","description":"one of: englandWalesNorthernIreland, scotland. Income-tax region.","enum":["englandWalesNorthernIreland","scotland"]},"pensionContributionRatePercent":{"type":"number","description":"finite number from 0 to 100. Employee pension contribution rate.","minimum":0,"maximum":100},"pensionContributionBasis":{"type":"string","description":"one of: qualifyingEarnings, grossPay. Pay basis used for pension contribution.","enum":["qualifyingEarnings","grossPay"]},"pensionReliefMethod":{"type":"string","description":"one of: netPay, reliefAtSource. Pension tax-relief method.","enum":["netPay","reliefAtSource"]}},"example":{"taxRegion":"englandWalesNorthernIreland","pensionContributionRatePercent":5,"pensionContributionBasis":"grossPay","pensionReliefMethod":"netPay"}},"denmark":{"type":"object","description":"Municipal and church tax overrides.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 35. Municipal tax rate override.","minimum":0,"maximum":35},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 2. Optional church tax rate.","minimum":0,"maximum":2}},"example":{"municipalTaxRatePercent":25.1,"churchTaxRatePercent":0.7}},"japan":{"type":"object","description":"Health insurance, care insurance, and resident tax settings.","additionalProperties":false,"properties":{"healthInsuranceRatePercent":{"type":"number","description":"finite number from 0 to 8. Employee health-insurance rate override.","minimum":0,"maximum":8},"careInsuranceStatus":{"type":"string","description":"one of: notApplicable, age40To64. Care-insurance applicability.","enum":["notApplicable","age40To64"]},"residentTaxRatePercent":{"type":"number","description":"finite number from 0 to 15. Resident tax rate override.","minimum":0,"maximum":15}},"example":{"careInsuranceStatus":"age40To64","residentTaxRatePercent":10}},"malta":{"type":"object","description":"Resident tax status and social-security age band.","additionalProperties":false,"properties":{"taxStatus":{"type":"string","description":"one of: single, married, marriedOneChild, marriedTwoOrMoreChildren, parent, parentOneChild, parentTwoOrMoreChildren. Resident income-tax status.","enum":["single","married","marriedOneChild","marriedTwoOrMoreChildren","parent","parentOneChild","parentTwoOrMoreChildren"]},"socialSecurityAgeBand":{"type":"string","description":"one of: born1962OrLater, bornUpTo1961. Class 1 social-security age band.","enum":["born1962OrLater","bornUpTo1961"]}},"example":{"taxStatus":"single","socialSecurityAgeBand":"born1962OrLater"}},"newZealand":{"type":"object","description":"KiwiSaver and student-loan deduction rates.","additionalProperties":false,"properties":{"kiwiSaverRatePercent":{"type":"number","description":"finite number from 0 to 10. KiwiSaver employee contribution rate.","minimum":0,"maximum":10},"studentLoanRatePercent":{"type":"number","description":"finite number from 0 to 12. Student-loan repayment rate.","minimum":0,"maximum":12}},"example":{"kiwiSaverRatePercent":3,"studentLoanRatePercent":12}},"australia":{"type":"object","description":"HELP/STSL study-loan repayment status.","additionalProperties":false,"properties":{"studyLoanStatus":{"type":"string","description":"one of: none, studyLoan. Study-loan repayment mode.","enum":["none","studyLoan"]}},"example":{"studyLoanStatus":"studyLoan"}},"france":{"type":"object","description":"Household tax parts for income-tax estimate.","additionalProperties":false,"properties":{"taxParts":{"type":"number","description":"finite number from 1 to 10. French household tax parts.","minimum":1,"maximum":10}},"example":{"taxParts":1}},"israel":{"type":"object","description":"Tax credit points and employee pension rate.","additionalProperties":false,"properties":{"taxCreditPoints":{"type":"number","description":"finite number from 0 to 20. Income-tax credit points.","minimum":0,"maximum":20},"pensionRatePercent":{"type":"number","description":"finite number from 0 to 20. Employee pension contribution rate.","minimum":0,"maximum":20}},"example":{"taxCreditPoints":2.25,"pensionRatePercent":6}},"italy":{"type":"object","description":"Employee social-security and local surtax rates.","additionalProperties":false,"properties":{"employeeSocialSecurityRatePercent":{"type":"number","description":"finite number from 0 to 15. Employee social-security contribution rate override.","minimum":0,"maximum":15},"regionalTaxRatePercent":{"type":"number","description":"finite number from 0 to 3.33. Regional surtax rate.","minimum":0,"maximum":3.33},"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 0.9. Municipal surtax rate.","minimum":0,"maximum":0.9}},"example":{"employeeSocialSecurityRatePercent":9.19,"regionalTaxRatePercent":1.23,"municipalTaxRatePercent":0.8}},"ireland":{"type":"object","description":"PAYE profile, USC, PRSI period, partner income, pension, and extra credits.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: single, singleParent, marriedOneIncome, marriedTwoIncomes. PAYE tax profile.","enum":["single","singleParent","marriedOneIncome","marriedTwoIncomes"]},"uscStatus":{"type":"string","description":"one of: standard, reduced. USC rate profile.","enum":["standard","reduced"]},"prsiPeriod":{"type":"string","description":"one of: fullYear2026, beforeOctober2026, fromOctober2026. PRSI period rate.","enum":["fullYear2026","beforeOctober2026","fromOctober2026"]},"partnerIncomeAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual partner income for married two-income calculations.","minimum":0,"maximum":1000000000000},"pensionContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pension contribution.","minimum":0,"maximum":1000000000000},"additionalTaxCreditsAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Additional annual tax credits.","minimum":0,"maximum":1000000000000}},"example":{"taxProfile":"single","uscStatus":"standard","pensionContributionAnnual":3000}},"finland":{"type":"object","description":"Municipal/church tax and public broadcasting tax switch.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 12. Municipal income-tax rate.","minimum":0,"maximum":12},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 2.25. Optional church tax rate.","minimum":0,"maximum":2.25},"includePublicBroadcastingTax":{"type":"boolean","description":"true or false. Whether to include public broadcasting tax."}},"example":{"municipalTaxRatePercent":7.5,"includePublicBroadcastingTax":true}},"czechia":{"type":"object","description":"Taxpayer credit and social/health insurance profile.","additionalProperties":false,"properties":{"taxpayerCredit":{"type":"string","description":"one of: claimed, notClaimed. Basic taxpayer credit treatment.","enum":["claimed","notClaimed"]},"socialInsuranceProfile":{"type":"string","description":"one of: standard, workingPensionerDiscount, notInsured. Social-insurance mode.","enum":["standard","workingPensionerDiscount","notInsured"]},"healthMinimumBase":{"type":"string","description":"one of: standard, exempt. Health-insurance minimum-base treatment.","enum":["standard","exempt"]}},"example":{"taxpayerCredit":"claimed","socialInsuranceProfile":"standard"}},"cuba":{"type":"object","description":"Special social-security contribution status.","additionalProperties":false,"properties":{"socialSecurityStatus":{"type":"string","description":"one of: standard, notContributing. Social-security contribution mode.","enum":["standard","notContributing"]}},"example":{"socialSecurityStatus":"standard"}},"hungary":{"type":"object","description":"Allowance eligibility, PIT exemption profile, children counts, and first-marriage months.","additionalProperties":false,"properties":{"allowanceEligibility":{"type":"string","description":"one of: eligible, notEligible. Tax-base allowance eligibility.","enum":["eligible","notEligible"]},"pitExemptionProfile":{"type":"string","description":"one of: none, under25, motherUnder30, motherTwoChildrenUnder40, motherThreeOrMoreChildren, motherFourOrMoreChildren. Selected PIT exemption profile.","enum":["none","under25","motherUnder30","motherTwoChildrenUnder40","motherThreeOrMoreChildren","motherFourOrMoreChildren"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 100. Dependent children count.","minimum":0,"maximum":100},"disabledDependentChildren":{"type":"integer","description":"integer from 0 to 100. Disabled dependent children count.","minimum":0,"maximum":100},"severeDisabilityPersonalAllowance":{"type":"boolean","description":"true or false. Whether to apply severe-disability personal allowance."},"firstMarriageMonths":{"type":"integer","description":"integer from 0 to 12. Months eligible for first-marriage allowance in the estimated tax year.","minimum":0,"maximum":12}},"example":{"allowanceEligibility":"eligible","pitExemptionProfile":"none","dependentChildren":1}},"iran":{"type":"object","description":"Employee social-insurance status.","additionalProperties":false,"properties":{"socialInsuranceStatus":{"type":"string","description":"one of: insuredCapped, notInsured. Social-insurance mode.","enum":["insuredCapped","notInsured"]}},"example":{"socialInsuranceStatus":"insuredCapped"}},"iraq":{"type":"object","description":"Tax profile, social-security mode, dependents, age flag, and risk allowance.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: bachelor, married. Personal allowance profile.","enum":["bachelor","married"]},"socialSecurityStatus":{"type":"string","description":"one of: insuredCapped, notInsured. Social-security mode.","enum":["insuredCapped","notInsured"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 100. Dependent children count.","minimum":0,"maximum":100},"over63":{"type":"boolean","description":"true or false. Whether the taxpayer is over 63."},"riskAllowancePercent":{"type":"number","description":"finite number from 0 to 30. Optional risk allowance percentage.","minimum":0,"maximum":30}},"example":{"taxProfile":"married","socialSecurityStatus":"insuredCapped","dependentChildren":2}},"mexico":{"type":"object","description":"IMSS wage-base factor.","additionalProperties":false,"properties":{"imssWageBaseFactor":{"type":"number","description":"finite number from 0.01 to 2. IMSS wage-base factor.","minimum":0.01,"maximum":2}},"example":{"imssWageBaseFactor":1}},"egypt":{"type":"object","description":"Social-insurance wage factor.","additionalProperties":false,"properties":{"socialInsuranceWageFactor":{"type":"number","description":"finite number from 0.01 to 2. Social-insurance wage factor.","minimum":0.01,"maximum":2}},"example":{"socialInsuranceWageFactor":1}},"afghanistan":{"type":"object","description":"Public/private pension profile.","additionalProperties":false,"properties":{"pensionProfile":{"type":"string","description":"one of: privateSector, civilService, securityForces. Pension deduction profile.","enum":["privateSector","civilService","securityForces"]}},"example":{"pensionProfile":"privateSector"}},"greece":{"type":"object","description":"Age band and dependent children.","additionalProperties":false,"properties":{"ageBand":{"type":"string","description":"one of: standard, upTo25, age26To30. Worker age band.","enum":["standard","upTo25","age26To30"]},"dependentChildren":{"type":"integer","description":"integer from 0 to 12. Dependent children count.","minimum":0,"maximum":12}},"example":{"ageBand":"standard","dependentChildren":1}},"india":{"type":"object","description":"EPF wage factor/cap and professional tax.","additionalProperties":false,"properties":{"epfWageFactor":{"type":"number","description":"finite number from 0 to 1. EPF wage factor.","minimum":0,"maximum":1},"epfMonthlyWageCap":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. EPF monthly wage cap.","minimum":0,"maximum":1000000000000},"professionalTaxAnnual":{"type":"number","description":"finite number from 0 to 2,500. Annual professional tax.","minimum":0,"maximum":2500}},"example":{"epfWageFactor":1,"professionalTaxAnnual":2500}},"sweden":{"type":"object","description":"Municipal income-tax rate.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 40. Municipal income-tax rate.","minimum":0,"maximum":40}},"example":{"municipalTaxRatePercent":32}},"brazil":{"type":"object","description":"Dependent count and other monthly deductions.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"otherMonthlyDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Other monthly deductions.","minimum":0,"maximum":1000000000000}},"example":{"dependents":1,"otherMonthlyDeductions":500}},"argentina":{"type":"object","description":"Spouse deduction and child count.","additionalProperties":false,"properties":{"spouseDeduction":{"type":"string","description":"one of: notClaimed, claimed. Spouse deduction status.","enum":["notClaimed","claimed"]},"children":{"type":"integer","description":"integer from 0 to 10. Child count.","minimum":0,"maximum":10}},"example":{"spouseDeduction":"notClaimed","children":1}},"romania":{"type":"object","description":"Dependents, enrolled children, young-employee status, and minimum-wage relief mode.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"enrolledChildren":{"type":"integer","description":"integer from 0 to 20. Enrolled children count.","minimum":0,"maximum":20},"youngEmployeeStatus":{"type":"string","description":"one of: standard, under26. Young employee treatment.","enum":["standard","under26"]},"minimumWageReliefStatus":{"type":"string","description":"one of: auto, off. Minimum-wage relief treatment.","enum":["auto","off"]}},"example":{"dependents":1,"minimumWageReliefStatus":"auto"}},"portugal":{"type":"object","description":"Tax situation, dependents, and pay periods.","additionalProperties":false,"properties":{"taxSituation":{"type":"string","description":"one of: singleNoDependentsOrMarriedTwoEarners, singleWithDependents, marriedSingleEarner. IRS withholding situation.","enum":["singleNoDependentsOrMarriedTwoEarners","singleWithDependents","marriedSingleEarner"]},"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"payPeriods":{"type":"integer","description":"one of: 12, 14. Number of annual salary payment periods.","enum":[12,14]}},"example":{"taxSituation":"singleNoDependentsOrMarriedTwoEarners","payPeriods":14}},"spain":{"type":"object","description":"Regional income-tax rate override.","additionalProperties":false,"properties":{"regionalTaxRatePercent":{"type":"number","description":"finite number from 0 to 10. Regional IRPF rate adjustment.","minimum":0,"maximum":10}},"example":{"regionalTaxRatePercent":9.5}},"democraticRepublicOfTheCongo":{"type":"object","description":"Dependent count.","additionalProperties":false,"properties":{"dependents":{"type":"integer","description":"integer from 0 to 9. Dependent count.","minimum":0,"maximum":9}},"example":{"dependents":2}},"indonesia":{"type":"object","description":"Tax status and dependent count.","additionalProperties":false,"properties":{"taxStatus":{"type":"string","description":"one of: single, married. PTKP tax status.","enum":["single","married"]},"dependents":{"type":"integer","description":"integer from 0 to 3. Dependent count.","minimum":0,"maximum":3}},"example":{"taxStatus":"single","dependents":1}},"netherlands":{"type":"object","description":"Payroll tax credit and employee pension rate.","additionalProperties":false,"properties":{"payrollTaxCredit":{"type":"string","description":"one of: applied, notApplied. Payroll tax credit treatment.","enum":["applied","notApplied"]},"employeePensionRatePercent":{"type":"number","description":"finite number from 0 to 30. Employee pension contribution rate.","minimum":0,"maximum":30}},"example":{"payrollTaxCredit":"applied","employeePensionRatePercent":5}},"bangladesh":{"type":"object","description":"Taxpayer category and allowable investments.","additionalProperties":false,"properties":{"taxpayerCategory":{"type":"string","description":"one of: general, womanOrSenior, disabledOrThirdGender, warWoundedFreedomFighter. Taxpayer threshold category.","enum":["general","womanOrSenior","disabledOrThirdGender","warWoundedFreedomFighter"]},"allowableInvestmentsAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual allowable investments for rebate estimate.","minimum":0,"maximum":1000000000000}},"example":{"taxpayerCategory":"general","allowableInvestmentsAnnual":100000}},"canada":{"type":"object","description":"Province selection and annual pre-tax deductions.","additionalProperties":false,"properties":{"province":{"type":"string","description":"one of: ON, BC, AB. Province used for province income tax.","enum":["ON","BC","AB"]},"annualPreTaxDeductions":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual pre-tax deductions.","minimum":0,"maximum":1000000000000}},"example":{"province":"ON","annualPreTaxDeductions":0}},"belgium":{"type":"object","description":"Municipal tax rate.","additionalProperties":false,"properties":{"municipalTaxRatePercent":{"type":"number","description":"finite number from 0 to 9. Municipal tax rate.","minimum":0,"maximum":9}},"example":{"municipalTaxRatePercent":7}},"china":{"type":"object","description":"Employee social and housing fund rate.","additionalProperties":false,"properties":{"employeeSocialHousingRatePercent":{"type":"number","description":"finite number from 0 to 40. Employee social insurance and housing fund rate.","minimum":0,"maximum":40}},"example":{"employeeSocialHousingRatePercent":18}},"switzerland":{"type":"object","description":"Occupational pension and canton/commune/church tax rates.","additionalProperties":false,"properties":{"occupationalPensionRatePercent":{"type":"number","description":"finite number from 0 to 25. Occupational pension contribution rate.","minimum":0,"maximum":25},"cantonCommuneChurchTaxRatePercent":{"type":"number","description":"finite number from 0 to 30. Combined canton, commune, and church tax estimate.","minimum":0,"maximum":30}},"example":{"occupationalPensionRatePercent":7,"cantonCommuneChurchTaxRatePercent":8}},"unitedArabEmirates":{"type":"object","description":"Employee pension rate.","additionalProperties":false,"properties":{"employeePensionRatePercent":{"type":"number","description":"finite number from 0 to 20. Optional employee pension or social-security rate.","minimum":0,"maximum":20}},"example":{"employeePensionRatePercent":5}},"qatar":{"type":"object","description":"Employee social-insurance rate.","additionalProperties":false,"properties":{"employeeSocialInsuranceRatePercent":{"type":"number","description":"finite number from 0 to 7. Optional employee social-insurance rate.","minimum":0,"maximum":7}},"example":{"employeeSocialInsuranceRatePercent":5}},"singapore":{"type":"object","description":"Tax residency, CPF profile, and CPF age band.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Income-tax residency.","enum":["resident","nonResident"]},"cpfProfile":{"type":"string","description":"one of: citizenOrSprThirdYear, noCpf. CPF contribution profile.","enum":["citizenOrSprThirdYear","noCpf"]},"cpfAgeBand":{"type":"string","description":"one of: upTo55, age55To60, age60To65, age65To70, above70. CPF age band.","enum":["upTo55","age55To60","age60To65","age65To70","above70"]}},"example":{"taxResidency":"resident","cpfProfile":"citizenOrSprThirdYear","cpfAgeBand":"upTo55"}},"tanzania":{"type":"object","description":"Employment status and retirement scheme.","additionalProperties":false,"properties":{"employmentStatus":{"type":"string","description":"one of: residentPrimary, residentSecondary, nonResident. PAYE employment/residency status.","enum":["residentPrimary","residentSecondary","nonResident"]},"retirementScheme":{"type":"string","description":"one of: nssfStandard, nssfFivePercent, psssf, none. Retirement contribution scheme.","enum":["nssfStandard","nssfFivePercent","psssf","none"]}},"example":{"employmentStatus":"residentPrimary","retirementScheme":"nssfStandard"}},"sudan":{"type":"object","description":"Tax residency and statutory contribution status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Employment tax residency.","enum":["resident","nonResident"]},"statutoryContributionStatus":{"type":"string","description":"one of: formalSector, pensionOnly, notContributing. Pension/health contribution mode.","enum":["formalSector","pensionOnly","notContributing"]}},"example":{"taxResidency":"resident","statutoryContributionStatus":"formalSector"}},"peru":{"type":"object","description":"Tax residency and pension system.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: domiciled, nonDomiciled. Tax residency.","enum":["domiciled","nonDomiciled"]},"pensionSystem":{"type":"string","description":"one of: afpMixed, afpHabitatFlow, afpIntegraFlow, afpPrimaFlow, afpProfuturoFlow, onp, none. Pension system.","enum":["afpMixed","afpHabitatFlow","afpIntegraFlow","afpPrimaFlow","afpProfuturoFlow","onp","none"]}},"example":{"taxResidency":"domiciled","pensionSystem":"onp"}},"bolivia":{"type":"object","description":"Social contribution status and VAT invoice credit.","additionalProperties":false,"properties":{"socialContributionStatus":{"type":"string","description":"one of: contributing, employee65Plus, notContributing. Pension contribution mode.","enum":["contributing","employee65Plus","notContributing"]},"vatInvoiceCreditAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual VAT invoice credit.","minimum":0,"maximum":1000000000000}},"example":{"socialContributionStatus":"contributing","vatInvoiceCreditAnnual":12000}},"coteDIvoire":{"type":"object","description":"Family parts for RICF reduction.","additionalProperties":false,"properties":{"familyParts":{"type":"string","description":"one of: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5. Family parts.","enum":["1","1.5","2","2.5","3","3.5","4","4.5","5"]}},"example":{"familyParts":"1"}},"cambodia":{"type":"object","description":"Tax residency, spouse/dependents count, and NSSF pension status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Salary tax residency.","enum":["resident","nonResident"]},"dependentsAndSpouse":{"type":"integer","description":"integer from 0 to 20. Dependents and spouse count.","minimum":0,"maximum":20},"nssfPensionStatus":{"type":"string","description":"one of: participating, notParticipating. NSSF pension participation.","enum":["participating","notParticipating"]}},"example":{"taxResidency":"resident","dependentsAndSpouse":1,"nssfPensionStatus":"participating"}},"northKorea":{"type":"object","description":"Worker profile and foreign income-tax rate.","additionalProperties":false,"properties":{"workerProfile":{"type":"string","description":"one of: domesticCitizen, foreignIndividual, foreignResident. Worker profile.","enum":["domesticCitizen","foreignIndividual","foreignResident"]},"foreignIncomeTaxRatePercent":{"type":"number","description":"finite number from 5 to 30. Foreign individual income-tax rate.","minimum":5,"maximum":30}},"example":{"workerProfile":"domesticCitizen"}},"nepal":{"type":"object","description":"Tax profile, SSF, insurance deductions, remote-area category, and credits.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: residentSingle, residentCouple, nonResident. Salary tax profile.","enum":["residentSingle","residentCouple","nonResident"]},"ssfContributionStatus":{"type":"string","description":"one of: ssfContributor, notContributing. SSF participation.","enum":["ssfContributor","notContributing"]},"ssfBasicSalaryPercent":{"type":"number","description":"finite number from 0 to 100. SSF basic salary percentage.","minimum":0,"maximum":100},"lifeInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 40,000. Annual life-insurance premium.","minimum":0,"maximum":40000},"healthInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 20,000. Annual health-insurance premium.","minimum":0,"maximum":20000},"buildingInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 5,000. Annual building-insurance premium.","minimum":0,"maximum":5000},"remoteAreaCategory":{"type":"string","description":"one of: none, A, B, C, D, E. Remote-area deduction category.","enum":["none","A","B","C","D","E"]},"femaleTaxCreditStatus":{"type":"string","description":"one of: notClaimed, singleFemaleEmploymentIncome. Female employment-income credit status.","enum":["notClaimed","singleFemaleEmploymentIncome"]},"medicalExpenseAnnual":{"type":"number","description":"finite number from 0 to 10,000. Annual medical expense.","minimum":0,"maximum":10000}},"example":{"taxProfile":"residentSingle","ssfContributionStatus":"ssfContributor","remoteAreaCategory":"none"}},"myanmar":{"type":"object","description":"Tax profile, SSB status, spouse allowance, children, parents, insurance, and savings fund.","additionalProperties":false,"properties":{"taxProfile":{"type":"string","description":"one of: resident, nonResidentForeign, nonResidentCitizenAbroad. Salary tax profile.","enum":["resident","nonResidentForeign","nonResidentCitizenAbroad"]},"ssbContributionStatus":{"type":"string","description":"one of: ssbContributor, notContributing. SSB contribution status.","enum":["ssbContributor","notContributing"]},"spouseAllowance":{"type":"string","description":"one of: notClaimed, claimed. Spouse allowance status.","enum":["notClaimed","claimed"]},"children":{"type":"integer","description":"integer from 0 to 10. Child count.","minimum":0,"maximum":10},"dependentParents":{"type":"integer","description":"integer from 0 to 4. Dependent parents count.","minimum":0,"maximum":4},"lifeInsurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual life-insurance premium.","minimum":0,"maximum":1000000000000},"savingsFundContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual savings-fund contribution.","minimum":0,"maximum":1000000000000}},"example":{"taxProfile":"resident","ssbContributionStatus":"ssbContributor","spouseAllowance":"notClaimed"}},"moldova":{"type":"object","description":"Personal/spouse allowances, dependents, and health-insurance status.","additionalProperties":false,"properties":{"personalAllowance":{"type":"string","description":"one of: standard, major, notClaimed. Personal allowance status.","enum":["standard","major","notClaimed"]},"spouseAllowance":{"type":"string","description":"one of: notClaimed, majorSpouse. Spouse allowance status.","enum":["notClaimed","majorSpouse"]},"dependents":{"type":"integer","description":"integer from 0 to 20. Dependent count.","minimum":0,"maximum":20},"severeDisabilityDependents":{"type":"integer","description":"integer from 0 to 20. Severe-disability dependent count.","minimum":0,"maximum":20},"healthInsuranceStatus":{"type":"string","description":"one of: contributing, notContributing. Health-insurance contribution status.","enum":["contributing","notContributing"]}},"example":{"personalAllowance":"standard","spouseAllowance":"notClaimed","dependents":1}},"madagascar":{"type":"object","description":"Social contribution status, dependents, and monthly contribution cap.","additionalProperties":false,"properties":{"socialContributionStatus":{"type":"string","description":"one of: cnapsAndHealth, cnapsOnly, notContributing. Social contribution mode.","enum":["cnapsAndHealth","cnapsOnly","notContributing"]},"dependents":{"type":"integer","description":"integer from 0 to 50. Dependent count.","minimum":0,"maximum":50},"monthlyContributionCap":{"type":"number","description":"finite number from 1 to 100,000,000. Monthly contribution cap.","minimum":1,"maximum":100000000}},"example":{"socialContributionStatus":"cnapsAndHealth","dependents":1}},"kenya":{"type":"object","description":"Tax residency, NSSF mode, pension, insurance, medical fund, and mortgage interest.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. PAYE tax residency.","enum":["resident","nonResident"]},"nssfContributionStatus":{"type":"string","description":"one of: tierIAndII, notContributing. NSSF contribution status.","enum":["tierIAndII","notContributing"]},"additionalPensionContributionAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual additional pension contribution.","minimum":0,"maximum":1000000000000},"insurancePremiumAnnual":{"type":"number","description":"finite number from 0 to 400,000. Annual insurance premium.","minimum":0,"maximum":400000},"postRetirementMedicalFundAnnual":{"type":"number","description":"finite number from 0 to 1,000,000,000,000. Annual post-retirement medical fund contribution.","minimum":0,"maximum":1000000000000},"mortgageInterestAnnual":{"type":"number","description":"finite number from 0 to 360,000. Annual mortgage interest.","minimum":0,"maximum":360000}},"example":{"taxResidency":"resident","nssfContributionStatus":"tierIAndII"}},"uzbekistan":{"type":"object","description":"Tax residency and INPS participation.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Tax residency.","enum":["resident","nonResident"]},"inpsParticipation":{"type":"string","description":"one of: participant, notParticipating. INPS participation.","enum":["participant","notParticipating"]}},"example":{"taxResidency":"resident","inpsParticipation":"participant"}},"yemen":{"type":"object","description":"Tax residency and social-insurance status.","additionalProperties":false,"properties":{"taxResidency":{"type":"string","description":"one of: resident, nonResident. Salary tax residency.","enum":["resident","nonResident"]},"socialInsuranceStatus":{"type":"string","description":"one of: insured, notInsured. Social-insurance status.","enum":["insured","notInsured"]}},"example":{"taxResidency":"resident","socialInsuranceStatus":"insured"}},"germany":{"type":"object","description":"Health add-on, care status, and church tax rate.","additionalProperties":false,"properties":{"healthAdditionalRatePercent":{"type":"number","description":"finite number from 0 to 6. Additional statutory health-insurance rate.","minimum":0,"maximum":6},"careStatus":{"type":"string","description":"one of: withChildren, childless. Long-term care insurance status.","enum":["withChildren","childless"]},"churchTaxRatePercent":{"type":"number","description":"finite number from 0 to 9. Optional church tax rate.","minimum":0,"maximum":9}},"example":{"healthAdditionalRatePercent":1.7,"careStatus":"withChildren","churchTaxRatePercent":0}}},"oneOf":[{"required":["annualSalary"]},{"required":["monthlySalary"]},{"required":["salary"]}]},"NetSalaryResponse":{"type":"object","additionalProperties":false,"required":["result","quota"],"properties":{"result":{"type":"object","additionalProperties":false,"required":["country","currency","input","gross","net","deductions","workSchedule","assumptions"],"properties":{"country":{"type":"string"},"currency":{"type":"string","minLength":3,"maxLength":3},"input":{"type":"object","additionalProperties":false,"required":["salary","salaryPeriod","annualGross"],"properties":{"salary":{"type":"number","minimum":0},"salaryPeriod":{"type":"string","enum":["annual","monthly"]},"annualGross":{"type":"number","minimum":0}}},"gross":{"type":"object","additionalProperties":false,"required":["annual","monthly","hourly"],"properties":{"annual":{"type":"number","minimum":0},"monthly":{"type":"number","minimum":0},"hourly":{"type":"number","minimum":0}}},"net":{"type":"object","additionalProperties":false,"required":["annual","monthly","hourly"],"properties":{"annual":{"type":"number","minimum":0},"monthly":{"type":"number","minimum":0},"hourly":{"type":"number","minimum":0}}},"deductions":{"type":"object","additionalProperties":false,"required":["annual","monthly","effectiveRate","lines"],"properties":{"annual":{"type":"number","minimum":0},"monthly":{"type":"number","minimum":0},"effectiveRate":{"type":"number","minimum":0,"maximum":1},"lines":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["id","label","amount","detail"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"amount":{"type":"number"},"detail":{"type":"string"}}}}}},"workSchedule":{"type":"object","additionalProperties":false,"required":["hoursPerDay","daysPerWeek","annualHours"],"properties":{"hoursPerDay":{"type":"integer","enum":[8]},"daysPerWeek":{"type":"integer","enum":[5]},"annualHours":{"type":"integer","enum":[2080]}}},"assumptions":{"type":"array","items":{"type":"string"}}}},"quota":{"type":"object","additionalProperties":false,"required":["allowed","limit","used","remaining","resetAt"],"properties":{"allowed":{"type":"boolean"},"limit":{"type":"integer","minimum":0},"used":{"type":"integer","minimum":0},"remaining":{"type":"integer","minimum":0},"resetAt":{"type":"string","format":"date-time"}}}}},"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string"},"details":{"oneOf":[{"type":"array","items":{"type":"object","additionalProperties":true}},{"type":"object","additionalProperties":true}]}}}}},"Quota":{"type":"object","additionalProperties":false,"required":["allowed","limit","used","remaining","resetAt"],"properties":{"allowed":{"type":"boolean"},"limit":{"type":"integer","minimum":0},"used":{"type":"integer","minimum":0},"remaining":{"type":"integer","minimum":0},"resetAt":{"type":"string","format":"date-time"}}}}}}