{
  "openapi": "3.0.3",
  "info": {
    "title": "Payroll and Paycheck Calculator API",
    "version": "1.5.1",
    "description": "Take-home pay, US federal and state income tax, self-employment tax, UK and India income tax, and pay stubs. Estimate take-home pay per pay period (2026 US federal brackets, employee FICA, state income tax for all 50 states and DC, 401(k) and section 125 deductions, California SDI), US federal income tax by filing status, self-employment tax with quarterly estimates, state income tax, UK income tax with National Insurance and Scottish rates (2026/27), India income tax under the old and new regime (FY 2026-27), and build a pay stub from hours, rate and deduction percentages. Every tax response carries taxYear, sources and a disclaimer, and the tables are updated each tax year. The pay stub endpoint returns structured JSON (figures and document sections), not a PDF, and applies the percentages you send. These are estimators, not a payroll compliance engine: local and city taxes and employer-side taxes are not modelled. Nothing you send is stored. One X-API-Key header authenticates every call, and the same key works across every FreeDailyPro API. Every 4xx response is documented and none of them is billed.",
    "contact": {
      "name": "FreeDailyPro",
      "url": "https://www.freedailypro.com/developers",
      "email": "support@freedailypro.com"
    },
    "termsOfService": "https://www.freedailypro.com/terms",
    "x-logo": {
      "url": "https://www.freedailypro.com/favicon.ico"
    }
  },
  "servers": [
    {
      "url": "https://api.freedailypro.com",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "Developer hub, plans and MCP setup",
    "url": "https://www.freedailypro.com/developers"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "tags": [
    {
      "name": "Payroll & Paycheck",
      "description": "Take-home pay, US federal and state income tax, self-employment tax, UK and India income tax, and pay stubs."
    }
  ],
  "paths": {
    "/v1/converters/paycheck": {
      "post": {
        "summary": "Estimate take-home pay from salary: 2026 federal tax, FICA, state tax and pre-tax deductions",
        "operationId": "convertersPaycheck",
        "description": "Estimates take-home pay per pay period from yearly gross pay. Federal income tax uses the 2026 brackets and standard deduction for 'filingStatus' (single by default); FICA is the employee share (Social Security 6.2% up to the $184,500 wage base, Medicare 1.45%, Additional Medicare 0.9% above $200,000 single / $250,000 joint / $125,000 separate); 'state' (code or name) adds that state's 2026 income tax from the same table as the website; 'retirementPct' (traditional 401(k)) lowers income tax but not FICA; 'section125Annual' (health premiums, HSA/FSA) lowers both. 'federalRatePct' and 'stateRatePct' from the first version still work: when sent they replace the table lookup with a flat rate. If neither 'state' nor 'stateRatePct' is sent, no state income tax is included. California SDI: when 'state' is CA the response adds 'stateDisabilityInsurance' (per check, with 'stateDisabilityInsuranceName' and an annual figure) of 1.3% of all gross wages with no wage cap, deducted from net pay exactly as on the website's Paycheck and Income Tax calculators and the us-income-tax endpoint (a 401(k) deferral does not lower it; it is taken also when a flat 'stateRatePct' replaces the income-tax lookup). The 1.3% rate comes from the owner's brief citing the California EDD and could not be re-read on edd.ca.gov from the build environment (dataStatus for that line: unverified); NY, NJ, HI, RI, WA and MA payroll contributions are not modelled and a note says so. Returns per-check amounts, an 'annual' block, taxYear, sources, notes and a disclaimer. US federal figures are the IRS 2026 tax-year amounts from Revenue Procedure 2025-32 (brackets, standard deduction) and the SSA 2026 Social Security wage base of $184,500. Update process: all figures live in one table file that FreeDailyPro also uses for its website calculators (so the API and the website always agree) and are updated by FreeDailyPro each tax year; next review: November 2026, when the IRS and SSA publish the 2027 figures. No tax credits, local taxes or W-4 adjustments. Estimate, not tax advice. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "grossAnnual": {
                    "type": "number",
                    "description": "Gross pay for the year, in US dollars."
                  },
                  "payPeriodsPerYear": {
                    "description": "Pay periods per year: 52, 26, 24 or 12. Default 24.",
                    "type": "number"
                  },
                  "filingStatus": {
                    "description": "Federal filing status. Default single.",
                    "type": "string",
                    "enum": [
                      "single",
                      "married-joint",
                      "married-separate",
                      "head-of-household"
                    ]
                  },
                  "state": {
                    "description": "US state (two-letter code such as NY, or the full name; DC included). Adds that state's 2026 income tax from the same table as the website. Without it, no state income tax is included.",
                    "type": "string"
                  },
                  "retirementPct": {
                    "description": "Traditional 401(k)/403(b) deferral as a percent of gross pay. Lowers income tax but not FICA.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "section125Annual": {
                    "description": "Yearly pre-tax health, dental, HSA or FSA deductions. Lowers income tax and FICA.",
                    "type": "number",
                    "minimum": 0
                  },
                  "federalRatePct": {
                    "description": "Optional flat federal rate in percent. When sent it replaces the 2026 bracket calculation (first-version behaviour).",
                    "type": "number",
                    "minimum": 0
                  },
                  "stateRatePct": {
                    "description": "Optional flat state rate in percent. When sent it replaces the state lookup (first-version behaviour).",
                    "type": "number",
                    "minimum": 0
                  },
                  "otherDeductionPerCheck": {
                    "description": "Other after-tax deduction taken from each paycheck, in dollars.",
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "grossAnnual"
                ],
                "additionalProperties": false
              },
              "example": {
                "grossAnnual": 85000,
                "payPeriodsPerYear": 26,
                "filingStatus": "single",
                "state": "NY",
                "retirementPct": 5
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Paycheck estimator: 2026 US federal tax, FICA, state tax and pre-tax deductions",
                  "result": {
                    "taxYear": 2026,
                    "filingStatus": "single",
                    "payPeriodsPerYear": 26,
                    "grossPerCheck": 3269.23,
                    "federal": 343.65,
                    "state": 144.75,
                    "other": 0,
                    "socialSecurity": 202.69,
                    "medicare": 47.4,
                    "additionalMedicare": 0,
                    "fica": 250.1,
                    "retirement": 163.46,
                    "section125": 0,
                    "netPerCheck": 2367.27,
                    "estimatedAnnualNet": 61549,
                    "annual": {
                      "gross": 85000,
                      "federal": 8935,
                      "state": 3763.5,
                      "fica": 6502.5,
                      "retirement": 4250,
                      "section125": 0,
                      "other": 0,
                      "net": 61549,
                      "federalTaxableIncome": 64650
                    },
                    "federalSource": "2026 IRS brackets",
                    "stateSource": "New York schedule, tax year 2026 (official source); local taxes excluded",
                    "stateDetail": {
                      "code": "NY",
                      "name": "New York",
                      "taxYear": "2026",
                      "rateSource": "tax.ny.gov, NYS-50-T-NYS and NYS-50-T-Y (1/26) annual rate schedule: 3.9%, 4.4%, 5.15%, 5.4%, 5.9%",
                      "officialSource": true,
                      "localTaxNote": "New York City residents also pay city income tax of about 3.1% to 3.9%."
                    },
                    "sources": "IRS Rev. Proc. 2025-32 and SSA 2026 wage base. Tax year 2026. FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: November, when the IRS publishes next year's figures.",
                    "dataStatus": "checked",
                    "notes": [
                      "2026 federal brackets and standard deduction for single; employee FICA with the Social Security wage base of $184,500. Figures are per pay period unless the field says annual.",
                      "Pre-tax retirement (retirementPct) lowers income tax but not FICA; section125Annual (health premiums, HSA/FSA) lowers both. No tax credits, no local income tax, no W-4 adjustments."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Negative or missing grossAnnual, payPeriodsPerYear of 0 or less, or an unknown filingStatus or state; the body says which Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/self-employment-tax": {
      "post": {
        "summary": "Calculate US self-employment tax for 2026: Social Security wage base, Medicare and Additional Medicare",
        "operationId": "convertersSelfEmploymentTax",
        "description": "Self-employment tax on net profit for tax year 2026: net earnings are 92.35% of profit; Social Security 12.4% up to the $184,500 wage base (less any 'w2Wages' you send), Medicare 2.9% on everything, plus the 0.9% Additional Medicare Tax above $200,000 single / $250,000 joint / $125,000 separate ('filingStatus'). No tax is due under $400 of net earnings. 'seTax' (Social Security plus Medicare) keeps its first-version meaning; the Additional Medicare Tax is shown separately, and 'deductibleHalf' is the half you deduct from income. US federal figures are the IRS 2026 tax-year amounts from Revenue Procedure 2025-32 (brackets, standard deduction) and the SSA 2026 Social Security wage base of $184,500. Update process: all figures live in one table file that FreeDailyPro also uses for its website calculators (so the API and the website always agree) and are updated by FreeDailyPro each tax year; next review: November 2026, when the IRS and SSA publish the 2027 figures. Estimate, not tax advice. One quarterly payment: the response always includes 'quarterlySeTax', 'quarterlyPayment', 'schedule' (the four IRS due dates, 2026-04-15, 2026-06-15, 2026-09-15 and 2027-01-15, with each part) and 'steps'. With 'includeIncomeTax': true, quarterlyPayment is self-employment tax plus federal income tax (2026 brackets and standard deduction, after the deduction for half of the self-employment tax; with W-2 wages it is the extra tax the profit adds, assuming the wages' own tax is withheld); 'state' adds that state's income tax, and 'priorYearTax' (with optional 'priorYearAgi') returns the IRS safe-harbour alternative: the smaller of 100% of last year's tax (110% when last year's AGI was above $150,000, or $75,000 if married filing separately) and 90% of this year's self-employment plus federal income tax (IRS, 'Estimated tax', irs.gov/faqs/estimated-tax, read 30 Oct 2026). It is tested against the federal figure only; with 'state' the state gets its own test (safeHarbour.state: 90% of this year's state tax, or the smaller of last year's state tax and that when 'priorYearStateTax' is sent) and safeHarbour.annualPayment adds the two. 'method':'annualized' with 'cumulativeProfit' (profit through Mar 31, May 31, Aug 31) works each payment from income earned so far; 'ytdWithholding', 'paymentsMade' and 'asOf' return a 'remaining' block with what is still to pay and when. A negative netProfit is still a 400. Who calls it: accounting and invoicing apps for freelancers, gig-platform tax tools, bookkeeping dashboards, and chatbots or MCP agents. Worked example: {\"netProfit\":60000,\"includeIncomeTax\":true} returns seTax 8477.73 (2119.43 a quarter), federalIncomeTax 3559.47 (after the 7,932.23 qualified business income deduction, qbiDeduction), annualPayment 12037.2 and quarterlyPayment 3009.3; without includeIncomeTax quarterlyPayment is 2119.43. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "netProfit": {
                    "type": "number",
                    "description": "Net self-employment profit for the year, in US dollars."
                  },
                  "filingStatus": {
                    "description": "Federal filing status. Default single.",
                    "type": "string",
                    "enum": [
                      "single",
                      "married-joint",
                      "married-separate",
                      "head-of-household"
                    ]
                  },
                  "w2Wages": {
                    "description": "W-2 wages from a job in the same year. They use up part of the Social Security wage base and count toward the Additional Medicare threshold.",
                    "type": "number",
                    "minimum": 0
                  },
                  "includeIncomeTax": {
                    "description": "true adds federal income tax (2026 brackets, standard deduction, after the half self-employment tax deduction) so quarterlyPayment is the whole estimated payment. Default false: quarterlyPayment is the self-employment tax divided by 4.",
                    "type": "boolean"
                  },
                  "state": {
                    "description": "With includeIncomeTax: a US state (two-letter code or name) to add that state's income tax on the profit.",
                    "type": "string"
                  },
                  "priorYearTax": {
                    "description": "With includeIncomeTax: last year's federal total tax (self-employment plus income tax), for the IRS safe-harbour test on the federal part (100% of last year's tax, or 110% if priorYearAgi is above the threshold).",
                    "type": "number",
                    "minimum": 0
                  },
                  "priorYearAgi": {
                    "description": "With priorYearTax: last year's adjusted gross income; above $150,000 ($75,000 married filing separately) the safe harbour is 110% of last year's tax.",
                    "type": "number",
                    "minimum": 0
                  },
                  "priorYearStateTax": {
                    "description": "With includeIncomeTax and state: last year's state income tax, for the state's own safe-harbour test. Without it the state test is 90% of this year's state tax. priorYearTax is last year's federal total (self-employment plus income tax) and is tested against the federal figure only.",
                    "type": "number",
                    "minimum": 0
                  },
                  "method": {
                    "description": "'even' (default): four equal payments. 'annualized': each payment follows the income earned so far (needs cumulativeProfit); good for seasonal income.",
                    "type": "string",
                    "enum": [
                      "even",
                      "annualized"
                    ]
                  },
                  "cumulativeProfit": {
                    "description": "With method 'annualized': net profit earned so far through Mar 31, May 31 and Aug 31 (cumulative, rising, not above netProfit). netProfit is the full-year figure.",
                    "minItems": 3,
                    "maxItems": 3,
                    "type": "array",
                    "items": {
                      "type": "number",
                      "minimum": 0
                    }
                  },
                  "ytdWithholding": {
                    "description": "With includeIncomeTax: federal income tax already withheld this year (for example from a W-2 job). Counts against the yearly total in the 'remaining' block and the safe harbour.",
                    "type": "number",
                    "minimum": 0
                  },
                  "paymentsMade": {
                    "description": "Estimated payments already made this year. Counts against the yearly total in the 'remaining' block and the safe harbour.",
                    "type": "number",
                    "minimum": 0
                  },
                  "asOf": {
                    "description": "YYYY-MM-DD. Payments due on or before this date are treated as past when spreading what is still to pay. Default: all four are still ahead.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "netProfit"
                ],
                "additionalProperties": false
              },
              "example": {
                "netProfit": 90000,
                "filingStatus": "single"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Self-employment tax: 2026 wage base, Medicare and Additional Medicare",
                  "result": {
                    "quarterlySeTax": 3179.15,
                    "quarterlyPayment": 3179.15,
                    "includesIncomeTax": false,
                    "method": "even",
                    "schedule": [
                      {
                        "payment": "Q1",
                        "incomeEarned": "Jan 1 - Mar 31",
                        "due": "2026-04-15",
                        "seTax": 3179.15,
                        "federalIncomeTax": 0,
                        "stateIncomeTax": 0,
                        "total": 3179.15
                      },
                      {
                        "payment": "Q2",
                        "incomeEarned": "Apr 1 - May 31",
                        "due": "2026-06-15",
                        "seTax": 3179.15,
                        "federalIncomeTax": 0,
                        "stateIncomeTax": 0,
                        "total": 3179.15
                      },
                      {
                        "payment": "Q3",
                        "incomeEarned": "Jun 1 - Aug 31",
                        "due": "2026-09-15",
                        "seTax": 3179.15,
                        "federalIncomeTax": 0,
                        "stateIncomeTax": 0,
                        "total": 3179.15
                      },
                      "..."
                    ],
                    "steps": [
                      {
                        "label": "Net earnings",
                        "formula": "Net profit x 92.35%",
                        "inputs": {
                          "Net profit": 90000
                        },
                        "result": 83115
                      },
                      {
                        "label": "Self-employment tax",
                        "formula": "Social Security 12.4% (up to the wage base, less W-2 wages) + Medicare 2.9% + Additional Medicare 0.9% above the threshold",
                        "inputs": {
                          "Social Security": 10306.26,
                          "Medicare": 2410.34,
                          "Additional Medicare": 0
                        },
                        "result": 12716.6
                      },
                      {
                        "label": "Per quarter (self-employment tax only)",
                        "formula": "Self-employment tax / 4",
                        "inputs": {
                          "Self-employment tax": 12716.6
                        },
                        "result": 3179.15
                      }
                    ],
                    "taxYear": 2026,
                    "filingStatus": "single",
                    "taxableBase": 83115,
                    "seTax": 12716.6,
                    "socialSecurity": 10306.26,
                    "medicare": 2410.34,
                    "additionalMedicare": 0,
                    "totalWithAdditionalMedicare": 12716.6,
                    "deductibleHalf": 6358.3,
                    "socialSecurityWageBase": 184500,
                    "sources": "IRS Rev. Proc. 2025-32 and SSA 2026 wage base. Tax year 2026. FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: November, when the IRS publishes next year's figures.",
                    "dataStatus": "checked",
                    "notes": [
                      "Net earnings = profit x 92.35%. Social Security 12.4% applies up to the 2026 wage base of $184,500 (less any w2Wages you send); Medicare 2.9% on everything; Additional Medicare 0.9% above $200,000 (single/head of household), $250,000 (joint) or $125,000 (separate). No self-employment tax is due when...",
                      "Half of seTax is deductible when working out income tax (deductibleHalf)."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Negative or missing netProfit (a loss is not accepted: there is no self-employment tax on a loss), a negative w2Wages, an unknown filingStatus or state, or state, priorYearTax or priorYearAgi sent without includeIncomeTax Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/us-income-tax": {
      "post": {
        "summary": "Estimate US federal income tax for 2026 with filing status, deductions, FICA and state tax",
        "operationId": "convertersUsIncomeTax",
        "description": "Estimates US federal income tax for tax year 2026. Send EITHER 'taxableIncome' (income after deductions) OR 'grossIncome' (before deductions). Optional 'filingStatus': single (default), married-joint, married-separate or head-of-household; each has its own 2026 brackets and standard deduction ($16,100 single, $32,200 joint, $16,100 separate, $24,150 head of household). With grossIncome you can also send 'deduction' ('standard' by default, or 'itemized' with 'itemizedDeductions'), 'preTaxDeductions' (treated like a traditional 401(k): lowers income tax, not FICA), 'selfEmployed' (self-employment tax instead of employee FICA) and 'state' (US state code or name, adds that state's 2026 income tax from the same table as /v1/converters/state-tax; for California on employee wages it also adds State Disability Insurance at 1.3% of all 2026 wages, no wage cap, shown as state.statePayrollTax and included in totalTax and takeHome; not applied when selfEmployed is true; other states' disability and paid-leave contributions are not included and a note says so). The response always includes taxYear, filingStatus, the bracket-by-bracket breakdown, marginal and effective rates, 'sources', 'dataStatus' and a 'disclaimer'; the first-version fields taxableIncome, tax and effectiveRatePct are unchanged in meaning. Where the data comes from: US federal figures are the IRS 2026 tax-year amounts from Revenue Procedure 2025-32 (brackets, standard deduction) and the SSA 2026 Social Security wage base of $184,500. Update process: all figures live in one table file that FreeDailyPro also uses for its website calculators (so the API and the website always agree) and are updated by FreeDailyPro each tax year; next review: November 2026, when the IRS and SSA publish the 2027 figures. Head of household and married-filing-separately thresholds were confirmed against published summaries of the Revenue Procedure. With selfEmployed true the response also takes the qualified business income (QBI) deduction (qbiDeduction: 20% of profit less half the self-employment tax, capped at 20% of taxable income before it; not taken above the 24%-bracket taxable-income threshold, where wage and property limits apply) and the state tax is worked on income after half the self-employment tax. Not modelled: tax credits, capital gains, AMT, net investment income tax, local taxes. Estimate, not tax advice. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "taxableIncome": {
                    "description": "Income after deductions. Send this OR grossIncome.",
                    "type": "number"
                  },
                  "grossIncome": {
                    "description": "Gross income before deductions (wages or profit). The standard or itemized deduction is applied for you, and FICA and optional state tax are added. Send this OR taxableIncome.",
                    "type": "number"
                  },
                  "filingStatus": {
                    "description": "Federal filing status. Default single.",
                    "type": "string",
                    "enum": [
                      "single",
                      "married-joint",
                      "married-separate",
                      "head-of-household"
                    ]
                  },
                  "deduction": {
                    "description": "With grossIncome. Default standard (2026 amount for the filing status).",
                    "type": "string",
                    "enum": [
                      "standard",
                      "itemized"
                    ]
                  },
                  "itemizedDeductions": {
                    "description": "With deduction 'itemized': the total of your itemized deductions.",
                    "type": "number",
                    "minimum": 0
                  },
                  "preTaxDeductions": {
                    "description": "With grossIncome: yearly pre-tax deductions such as traditional 401(k). Lowers income tax but not FICA.",
                    "type": "number",
                    "minimum": 0
                  },
                  "selfEmployed": {
                    "description": "With grossIncome: treat the income as self-employment profit (self-employment tax instead of employee FICA).",
                    "type": "boolean"
                  },
                  "state": {
                    "description": "With grossIncome: US state (two-letter code or name) to add that state's 2026 income tax.",
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "grossIncome": 100000,
                "filingStatus": "single",
                "state": "NY"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "US federal income tax estimate with 2026 brackets, filing status, deductions, FICA and state tax",
                  "result": {
                    "mode": "grossIncome",
                    "taxYear": 2026,
                    "filingStatus": "single",
                    "sources": "IRS Rev. Proc. 2025-32 and SSA 2026 wage base. Tax year 2026. FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: November, when the IRS publishes next year's figures.",
                    "dataStatus": "checked",
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser.",
                    "grossIncome": 100000,
                    "preTaxDeductions": 0,
                    "adjustedGrossIncome": 100000,
                    "deduction": {
                      "type": "standard",
                      "amount": 16100
                    },
                    "taxableIncome": 83900,
                    "tax": 13170,
                    "federalIncomeTax": 13170,
                    "effectiveRatePct": 15.7,
                    "marginalRatePct": 22,
                    "brackets": [
                      {
                        "fromIncome": 0,
                        "toIncome": 12400,
                        "ratePct": 10,
                        "taxableAmount": 12400,
                        "tax": 1240
                      },
                      {
                        "fromIncome": 12400,
                        "toIncome": 50400,
                        "ratePct": 12,
                        "taxableAmount": 38000,
                        "tax": 4560
                      },
                      {
                        "fromIncome": 50400,
                        "toIncome": 83900,
                        "ratePct": 22,
                        "taxableAmount": 33500,
                        "tax": 7370
                      }
                    ],
                    "employeeFica": {
                      "total": 7650,
                      "socialSecurity": 6200,
                      "medicare": 1450,
                      "additionalMedicare": 0
                    },
                    "state": {
                      "code": "NY",
                      "name": "New York",
                      "kind": "progressive",
                      "stateIncomeTax": 4859.75,
                      "stateTaxableIncome": 92000,
                      "effectiveRatePct": 4.86,
                      "taxYear": "2026",
                      "rateSource": "tax.ny.gov, NYS-50-T-NYS and NYS-50-T-Y (1/26) annual rate schedule: 3.9%, 4.4%, 5.15%, 5.4%, 5.9%",
                      "officialSource": true,
                      "localTaxNote": "New York City residents also pay city income tax of about 3.1% to 3.9%.",
                      "note": null
                    },
                    "totalTax": 25679.75,
                    "effectiveTotalRatePct": 25.68,
                    "takeHome": 74320.25,
                    "notes": [
                      "Federal tax on ordinary income only (wages or business profit). Tax credits, capital gains, AMT, the net investment income tax and other adjustments are not modelled. The qualified business income deduction is taken for selfEmployed income in the simple case only.",
                      "Brackets: 2026 IRS table for single. Social Security wage base used for FICA: $184,500 (SSA 2026).",
                      "State figure from the New York schedule (tax year 2026); local income taxes are not included (New York City residents also pay city income tax of about 3.1% to 3.9%.). Itemized deductions are applied to the federal figure only.",
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Neither or both of taxableIncome and grossIncome, a negative amount, an unknown filingStatus or state, 'itemized' without itemizedDeductions, or state/deduction fields sent with taxableIncome; the body says which Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/india-income-tax": {
      "post": {
        "summary": "Calculate India income tax for FY 2026-27 under the old or new regime",
        "operationId": "convertersIndiaIncomeTax",
        "description": "Send annual salary or pension income as 'income' (rupees). Both regimes are always calculated and returned in 'regimes' (old and new), with 'lowerTaxRegime' and the saving. New regime (section 115BAC): slabs 0% to ₹4 lakh, then 5%, 10%, 15%, 20%, 25% and 30% above ₹24 lakh; ₹75,000 standard deduction; section 87A rebate up to ₹60,000 (no tax up to ₹12 lakh taxable income, with marginal relief just above); surcharge capped at 25%. Old regime: age-based slabs ('age' below60, 60to80, above80), ₹50,000 standard deduction, deductions you send in 'deductions' (80C, 80D, HRA and so on, one total), 87A rebate up to ₹12,500 for income up to ₹5 lakh, surcharge up to 37%. Employer NPS (80CCD(2)) is capped at 14% of salary (new) or 10% (old). Health and education cess is 4% on both. 'otherIncome' is taxed without a standard deduction. The top-level 'tax' and 'effectiveRatePct' follow the 'regime' field (default old, as in the first version of this endpoint). Where the data comes from: Income Tax Department of India (slabs, rebate, surcharge rates) and Union Budget 2026 coverage, FY 2026-27 (AY 2027-28); slabs, standard deduction, rebate, surcharge and cess were compared with the department's surcharge page and published FY 2026-27 slab tables on 30 Oct 2026. Update process: one table file shared with the website, updated by FreeDailyPro every February after the Union Budget. Not modelled: capital gains and special-rate income, HUF, NRIs' special rules. Estimate, not tax advice. HRA and itemised deductions (B-0134): instead of the single 'deductions' total you can send 'itemised' (not both): { hra: { basicPlusDa, hraReceived, rentPaid, metro }, section80C, health80D: { self, selfSenior, parents, parentsSenior }, homeLoanInterest, nps80CCD1B, other }. The HRA exemption is the least of HRA received, rent paid less 10% of basic + DA, and 50% of basic + DA in a metro (40% elsewhere); the metro list under the Income-tax Rules 2026 is Delhi, Mumbai, Chennai, Kolkata, Bengaluru, Pune, Hyderabad and Ahmedabad (as reported by ClearTax and Moneylife, not read from the official text). Caps: 80C 1,50,000; 80CCD(1B) 50,000; 80D 25,000 for self and family and 25,000 for parents, each 50,000 for a senior citizen; home-loan interest on a self-occupied home 2,00,000. The response adds deductionBreakdown (every line with entered, cap, allowed and capped, the HRA workings and the total used in the old regime), deductionSteps, and a steps array inside each regime that shows the working to the tax. The slab, rebate, surcharge and cess logic is unchanged. Who calls it: payroll and HR tools answering regime-choice questions, salary-tax and take-home apps, tax-filing assistants, and chatbots or MCP agents. Worked example: {\"income\":1200000,\"regime\":\"old\",\"itemised\":{\"hra\":{\"basicPlusDa\":600000,\"hraReceived\":240000,\"rentPaid\":240000,\"metro\":true},\"section80C\":200000}} returns an HRA exemption of 180000 (rent less 10% of basic decides), 80C allowed 150000 (capped, 200000 entered), deductions of 330000 and old-regime taxable income of 820000. Integration scenario: an HR portal collects rent, HRA and the employee's investments at the start of the year and shows which regime is cheaper with the caps visible. The section amounts above are the long-standing limits; the Income-tax Act 2025 renumbered the sections from 1 April 2026 (80C became section 123, 80D section 126, HRA section 11) and the amounts were read from secondary sources on 30 Oct 2026, not from the Act's own text. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "income": {
                    "type": "number",
                    "description": "Annual salary or pension income in rupees. The standard deduction is taken off it."
                  },
                  "otherIncome": {
                    "description": "Other annual income in rupees (business, interest, rent). No standard deduction.",
                    "type": "number",
                    "minimum": 0
                  },
                  "regime": {
                    "description": "Which regime the top-level tax and effectiveRatePct report. Default old. Both regimes are always returned in 'regimes'.",
                    "type": "string",
                    "enum": [
                      "old",
                      "new"
                    ]
                  },
                  "age": {
                    "description": "Age group (old regime slabs). Default below60.",
                    "type": "string",
                    "enum": [
                      "below60",
                      "60to80",
                      "above80"
                    ]
                  },
                  "deductions": {
                    "description": "Old regime only: total of 80C, 80D, HRA, home-loan interest and other deductions.",
                    "type": "number",
                    "minimum": 0
                  },
                  "employerNps": {
                    "description": "Employer NPS contribution, section 80CCD(2), capped at 14% of salary (new) or 10% (old).",
                    "type": "number",
                    "minimum": 0
                  },
                  "itemised": {
                    "description": "Old-regime deductions itemised, with the caps applied and returned in deductionBreakdown. Use instead of deductions.",
                    "type": "object",
                    "properties": {
                      "hra": {
                        "description": "HRA exemption inputs (per year). metro true uses 50% of basic + DA, false 40%.",
                        "type": "object",
                        "properties": {
                          "basicPlusDa": {
                            "type": "number",
                            "minimum": 0
                          },
                          "hraReceived": {
                            "type": "number",
                            "minimum": 0
                          },
                          "rentPaid": {
                            "type": "number",
                            "minimum": 0
                          },
                          "metro": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "basicPlusDa",
                          "hraReceived",
                          "rentPaid",
                          "metro"
                        ],
                        "additionalProperties": false
                      },
                      "section80C": {
                        "description": "80C investments and payments; capped at 1,50,000.",
                        "type": "number",
                        "minimum": 0
                      },
                      "health80D": {
                        "description": "80D premiums for self and family and for parents; each capped at 25,000, or 50,000 for a senior citizen.",
                        "type": "object",
                        "properties": {
                          "self": {
                            "type": "number",
                            "minimum": 0
                          },
                          "selfSenior": {
                            "type": "boolean"
                          },
                          "parents": {
                            "type": "number",
                            "minimum": 0
                          },
                          "parentsSenior": {
                            "type": "boolean"
                          }
                        },
                        "additionalProperties": false
                      },
                      "homeLoanInterest": {
                        "description": "Interest on a self-occupied home loan; capped at 2,00,000.",
                        "type": "number",
                        "minimum": 0
                      },
                      "nps80CCD1B": {
                        "description": "Own NPS contribution, 80CCD(1B); capped at 50,000.",
                        "type": "number",
                        "minimum": 0
                      },
                      "other": {
                        "description": "Other deductions, added as entered (not capped here).",
                        "type": "number",
                        "minimum": 0
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "required": [
                  "income"
                ],
                "additionalProperties": false
              },
              "example": {
                "income": 1500000,
                "regime": "new"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "India income tax FY 2026-27: old and new regime, standard deduction, rebate, surcharge and cess",
                  "result": {
                    "income": 1500000,
                    "otherIncome": 0,
                    "currency": "INR",
                    "taxYear": "FY 2026-27",
                    "regime": "new",
                    "age": "below60",
                    "tax": 97500,
                    "effectiveRatePct": 6.5,
                    "regimes": {
                      "old": {
                        "taxableIncome": 1450000,
                        "standardDeduction": 50000,
                        "employerNpsDeducted": 0,
                        "slabTax": 247500,
                        "rebate87A": 0,
                        "marginalRelief": 0,
                        "surcharge": 0,
                        "cess": 9900,
                        "totalTax": 257400,
                        "effectiveRatePct": 17.16,
                        "monthlyTax": 21450,
                        "slabs": [
                          {
                            "fromIncome": 0,
                            "toIncome": 250000,
                            "ratePct": 0,
                            "amount": 250000,
                            "tax": 0
                          },
                          {
                            "fromIncome": 250000,
                            "toIncome": 500000,
                            "ratePct": 5,
                            "amount": 250000,
                            "tax": 12500
                          },
                          {
                            "fromIncome": 500000,
                            "toIncome": 1000000,
                            "ratePct": 20,
                            "amount": 500000,
                            "tax": 100000
                          },
                          "..."
                        ]
                      },
                      "new": {
                        "taxableIncome": 1425000,
                        "standardDeduction": 75000,
                        "employerNpsDeducted": 0,
                        "slabTax": 93750,
                        "rebate87A": 0,
                        "marginalRelief": 0,
                        "surcharge": 0,
                        "cess": 3750,
                        "totalTax": 97500,
                        "effectiveRatePct": 6.5,
                        "monthlyTax": 8125,
                        "slabs": [
                          {
                            "fromIncome": 0,
                            "toIncome": 400000,
                            "ratePct": 0,
                            "amount": 400000,
                            "tax": 0
                          },
                          {
                            "fromIncome": 400000,
                            "toIncome": 800000,
                            "ratePct": 5,
                            "amount": 400000,
                            "tax": 20000
                          },
                          {
                            "fromIncome": 800000,
                            "toIncome": 1200000,
                            "ratePct": 10,
                            "amount": 400000,
                            "tax": 40000
                          },
                          "..."
                        ]
                      }
                    },
                    "lowerTaxRegime": "new",
                    "taxSavingWithLowerRegime": 159900,
                    "sources": "Income Tax Department of India and Union Budget 2026. Tax year FY 2026-27 (AY 2027-28). FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: February, after the Union Budget.",
                    "dataStatus": "checked",
                    "notes": [
                      "income is salary or pension income: the standard deduction (₹75,000 new regime, ₹50,000 old regime) is taken off it. Send business or other income as otherIncome (no standard deduction). Both regimes are always calculated; 'tax' and 'effectiveRatePct' follow the regime field (default old, as in the ...",
                      "New regime (section 115BAC, the default for most taxpayers): 0 / 5 / 10 / 15 / 20 / 25 / 30% slabs at ₹4 / 8 / 12 / 16 / 20 / 24 lakh, 87A rebate up to ₹60,000 for taxable income up to ₹12 lakh with marginal relief, surcharge capped at 25%. Old regime: age-based slabs, 87A rebate up to ₹12,500 for i...",
                      "deductions (80C, 80D, HRA, home-loan interest and so on, entered as one total) apply to the old regime only. employerNps (80CCD(2)) is capped at 14% of salary (new) or 10% (old). Health and education cess is 4%. Capital gains and special-rate income are not modelled."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Negative or missing income, a negative otherIncome, deductions or employerNps, or an unknown regime or age group; itemised sent together with deductions, or a negative itemised amount Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/uk-tax": {
      "post": {
        "summary": "Calculate UK income tax and Class 1 National Insurance for 2026/27, with Scottish rates",
        "operationId": "convertersUkTax",
        "description": "Send gross annual salary as 'income' (pounds). Returns income tax, Class 1 employee National Insurance, take-home pay and the band-by-band breakdown for the 2026/27 tax year. England, Wales and Northern Ireland use 20%, 40% and 45% above the £12,570 personal allowance (tapered away between £100,000 and £125,140); send 'scotland': true for the Scottish bands (starter 19%, basic 20%, intermediate 21%, higher 42%, advanced 45%, top 48%, from the Scottish Budget of January 2026). National Insurance is the same everywhere in the UK: 8% between £12,570 and £50,270 and 2% above; employer NI (15% above £5,000) is returned for information. Optional 'pensionPct' and 'pensionType' (sacrifice, netpay, ras) model workplace pension tax relief. First-version fields income, tax (income tax) and effectiveRatePct are unchanged in meaning; 'tax' is income tax only, National Insurance is in 'nationalInsurance'. Where the data comes from: HMRC rates and thresholds and gov.scot / mygov.scot, which FreeDailyPro compared with the official pages (Scottish bands, NI thresholds and rates re-checked 30 Oct 2026). Update process: one table file shared with the website, updated by FreeDailyPro every April for the new tax year. Not covered: student loans, Class 2 and 4 NI (self-employed), savings and dividend income, Welsh-specific variations (rates match England). Estimate, not tax advice. Payslip matching (all optional): 'taxCode' (1257L, 1383M, 0T, BR, D0, D1, NT, K475, S1257L, C1257L, SBR, SD0 to SD3; meanings follow GOV.UK 'What the letters mean') replaces the standard allowance and its taper, and an S prefix selects the Scottish bands; 'bonus' (a one-off bonus or overtime) is taxed and charged National Insurance as pay and the response's 'bonus' block shows what it adds on its own; 'benefits' (taxable benefits in kind) add to taxable pay but not to employee National Insurance; 'marriageAllowance' (receive or give) applies when no code is sent. The response also carries 'perPeriod' (year, month, week and 4-weekly figures; a payslip uses cumulative tax, so one month can differ from a twelfth) and 'steps'. Who calls it: payroll and HR tools, job-offer and take-home comparison apps, recruitment platforms, and chatbots or MCP agents. Worked examples: {\"income\":40000,\"taxCode\":\"BR\"} returns incomeTax 8000; {\"income\":40000,\"bonus\":5000} returns bonus.extraIncomeTax 1000, extraNationalInsurance 400 and extraTakeHome 3600. Not modelled: emergency-code timing, the half-of-pay limit on K code deductions, Blind Person's Allowance, Class 1A employer NI on benefits. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "income": {
                    "type": "number",
                    "description": "Gross annual salary in pounds."
                  },
                  "scotland": {
                    "description": "true for Scottish income tax bands. Default false (England, Wales, Northern Ireland).",
                    "type": "boolean"
                  },
                  "pensionPct": {
                    "description": "Your pension contribution as a percent of salary.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "pensionType": {
                    "description": "How the pension is taken: salary sacrifice (default, lowers tax and National Insurance), net pay arrangement (lowers tax only) or relief at source.",
                    "type": "string",
                    "enum": [
                      "sacrifice",
                      "netpay",
                      "ras"
                    ]
                  },
                  "taxCode": {
                    "description": "Optional PAYE tax code as printed on a payslip: 1257L, 1383M, 0T, BR, D0, D1, NT, K475, S1257L (Scotland), C1257L (Wales), SBR, SD0 to SD3. A code replaces the standard allowance. Omit it for the standard allowance and taper.",
                    "type": "string",
                    "maxLength": 20
                  },
                  "bonus": {
                    "description": "A one-off bonus or overtime in the year, in pounds. Returns what it adds on its own in 'bonus'.",
                    "type": "number",
                    "minimum": 0
                  },
                  "benefits": {
                    "description": "Taxable benefits in kind per year, in pounds: added to taxable pay for income tax, not charged employee National Insurance.",
                    "type": "number",
                    "minimum": 0
                  },
                  "marriageAllowance": {
                    "description": "Marriage Allowance when no taxCode is sent: receive (tax reduced by up to £252) or give (£1,260 of allowance). Ignored when taxCode is sent.",
                    "type": "string",
                    "enum": [
                      "none",
                      "receive",
                      "give"
                    ]
                  }
                },
                "required": [
                  "income"
                ],
                "additionalProperties": false
              },
              "example": {
                "income": 60000,
                "scotland": true
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "UK income tax and Class 1 National Insurance 2026/27 with Scottish rates",
                  "result": {
                    "income": 60000,
                    "region": "Scotland",
                    "currency": "GBP",
                    "taxYear": "2026/27",
                    "tax": 13182.05,
                    "effectiveRatePct": 21.97,
                    "incomeTax": 13182.05,
                    "nationalInsurance": {
                      "class1Employee": 3210.6,
                      "mainRateAmount": 3016,
                      "upperRateAmount": 194.6
                    },
                    "employerNationalInsurance": 8250,
                    "personalAllowance": 12570,
                    "taxableIncome": 47430,
                    "pensionContribution": 0,
                    "takeHome": 43607.35,
                    "takeHomeMonthly": 3633.95,
                    "effectiveTotalRatePct": 27.32,
                    "bands": [
                      {
                        "band": "Starter rate",
                        "ratePct": 19,
                        "amount": 3967,
                        "tax": 753.73
                      },
                      {
                        "band": "Basic rate",
                        "ratePct": 20,
                        "amount": 12989,
                        "tax": 2597.8
                      },
                      {
                        "band": "Intermediate rate",
                        "ratePct": 21,
                        "amount": 14136,
                        "tax": 2968.56
                      },
                      "..."
                    ],
                    "sources": "HMRC, gov.scot and Student Loans Company threshold tables. Tax year 2026/27. FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: April.",
                    "dataStatus": "checked",
                    "notes": [
                      "Scottish income tax bands (starter 19%, basic 20%, intermediate 21%, higher 42%, advanced 45%, top 48%) from the Scottish Budget of January 2026, with the UK personal allowance. National Insurance is the same in Scotland as in the rest of the UK.",
                      "National Insurance is Class 1 employee (employed earner): 8% between £12,570 and £50,270 and 2% above, on salary. Employer National Insurance (15% above £5,000) is shown for information and is not deducted from take-home pay. Class 2 and 4 (self-employed) are not covered.",
                      "Personal allowance tapers away between £100,000 and £125,140. Student loans, Gift Aid, benefits in kind, savings and dividend income are not modelled."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Negative or missing income, an unknown pensionType, a taxCode that is not a valid PAYE code (the message gives examples), or a negative bonus or benefits Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/converters/state-tax": {
      "post": {
        "summary": "Calculate US state income tax from any state's 2026 schedule or a flat rate",
        "operationId": "convertersStateTax",
        "description": "Send 'income' and 'state' (two-letter code such as NY, or the full name; all 50 states and DC) to calculate that state's income tax from its bracket schedule, with the state standard deduction and personal exemptions for 'filingStatus' (single by default; married-joint uses the joint schedule). Example: New York, $100,000, single = $4,859.75. Send 'ratePct' instead (first-version behaviour) for a flat-rate calculation; ratePct wins if both are sent. 'includeLocal' adds an average local income tax where one exists. The response shows the bracket rows, the schedule's tax year ('rateSourceYear'; most states 2026, California uses the 2025 schedule, Vermont and North Dakota use 2025 bracket widths) and whether it came from an official source ('officialSource'), plus per-state notes. Where the data comes from: each state's revenue department and enacted 2026 laws, with the Tax Foundation 'State Individual Income Tax Rates and Brackets' table as the secondary source; NY, CA, WV and SC were read from official pages, the rest are marked as secondary-source estimates (dataStatus 'estimate'). Update process: one table file shared with the website, re-audited by FreeDailyPro every January (last audit 29 Oct 2026). Not modelled: federal-tax deductions (AL, MO, OR), phased-out exemptions, credits, local taxes unless includeLocal. Estimate, not tax advice. Local income tax: the response always includes 'stateTaxBeforeLocal', 'localTax' (0 unless includeLocal is true and the state has a typical average), 'localRatePct' and 'localTaxNotice' ({ status: included or excluded, averageRatePct, text }), a ready-to-show warning for Maryland, New York, Ohio, Pennsylvania, Indiana and Michigan when local tax is not included; 'steps' is the working. Who calls it: payroll, HR and relocation tools, take-home and job-offer comparison apps, freelancer tax planners, and chatbots or MCP agents. Worked example: {\"income\":75000,\"state\":\"MD\",\"includeLocal\":true} returns stateTaxBeforeLocal 3198.88, localTax 2190.4 (3.2% of the 68,450 taxable income) and tax 5389.28; without includeLocal, tax is 3198.88 and localTaxNotice.status is 'excluded'. The local averages (Indiana 1.6, Maryland 3.2, New York 3.5, Ohio 2, Pennsylvania 1.5 percent) are typical estimates that FreeDailyPro has not checked against each locality's own rate; Michigan city taxes have no average and are never added. More options: 'locality' (an id from the response's availableLocalities, for example ny-nyc, ny-yonkers, any Maryland county such as md-montgomery, pa-philadelphia, mi-detroit, mo-kansas-city, mo-st-louis, oh-columbus) adds that city or county's local income tax as its own 'locality' object, with its source page and the day it was read, and replaces the typical average; 'localityRole' worker uses the non-resident rate where one was confirmed. 'payrollPrograms' lists the state payroll programs as their own lines (California SDI 1.3%, New York PFL, New Jersey TDI and FLI, Washington PFML and WA Cares, Massachusetts PFML, Paid Leave Oregon; employee shares on wages, with the wage caps) and 'totalWithLocalAndPayroll' adds them to tax. 'tax' keeps its meaning. Localities and programs whose rates could not be confirmed from an official page (Indiana counties, other Ohio and Pennsylvania cities, other states' programs) are not included. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "income": {
                    "type": "number",
                    "description": "Annual income subject to state tax, in US dollars."
                  },
                  "state": {
                    "description": "US state (two-letter code such as NY, or the full name; DC included). Looks up that state's 2026 brackets, standard deduction and exemptions. Send this or ratePct.",
                    "type": "string"
                  },
                  "ratePct": {
                    "description": "Flat rate in percent (first-version behaviour). Takes priority over state.",
                    "type": "number"
                  },
                  "filingStatus": {
                    "description": "Filing status for the state schedule. Default single.",
                    "type": "string",
                    "enum": [
                      "single",
                      "married-joint",
                      "married-separate",
                      "head-of-household"
                    ]
                  },
                  "includeLocal": {
                    "description": "true adds an average local income tax where the state has local taxes (an estimate). Default false.",
                    "type": "boolean"
                  },
                  "locality": {
                    "description": "A named city or county for the chosen state (id from the response's availableLocalities, e.g. ny-nyc, ny-yonkers, md-montgomery, pa-philadelphia, mi-detroit, mo-kansas-city, mo-st-louis, oh-columbus). Adds its local income tax as its own 'locality' object and replaces the typical average (includeLocal is then ignored). 'tax' is unchanged; see totalWithLocalAndPayroll.",
                    "type": "string"
                  },
                  "localityRole": {
                    "description": "With locality: resident (default) or worker (live elsewhere, work there) where a non-resident rate was confirmed (Philadelphia, Detroit, Kansas City, St. Louis).",
                    "type": "string",
                    "enum": [
                      "resident",
                      "worker"
                    ]
                  }
                },
                "required": [
                  "income"
                ],
                "additionalProperties": false
              },
              "example": {
                "income": 100000,
                "state": "NY",
                "filingStatus": "single"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "US state income tax with a 50-state schedule lookup",
                  "result": {
                    "income": 100000,
                    "state": "NY",
                    "stateName": "New York",
                    "kind": "progressive",
                    "filingStatus": "single",
                    "tax": 4859.75,
                    "taxableIncome": 92000,
                    "effectiveRatePct": 4.86,
                    "marginalRatePct": 5.9,
                    "brackets": [
                      {
                        "fromIncome": 0,
                        "toIncome": 8500,
                        "ratePct": 3.9,
                        "tax": 331.5
                      },
                      {
                        "fromIncome": 8500,
                        "toIncome": 11700,
                        "ratePct": 4.4,
                        "tax": 140.8
                      },
                      {
                        "fromIncome": 11700,
                        "toIncome": 13900,
                        "ratePct": 5.15,
                        "tax": 113.3
                      },
                      "..."
                    ],
                    "rateSource": "tax.ny.gov, NYS-50-T-NYS and NYS-50-T-Y (1/26) annual rate schedule: 3.9%, 4.4%, 5.15%, 5.4%, 5.9%",
                    "rateSourceYear": "2026",
                    "officialSource": true,
                    "localIncluded": false,
                    "taxYear": 2026,
                    "sources": "Each state's revenue department and enacted 2026 laws; per-state notes name the exact source. Tax year 2026 (California uses the 2025 schedule; Vermont and North Dakota use 2025 bracket widths). FreeDailyPro table last checked 2026-10-29 (compiled from secondary sources, confirm with the authority)....",
                    "dataStatus": "estimate",
                    "notes": [
                      "State schedule for New York, tax year 2026: tax.ny.gov, NYS-50-T-NYS and NYS-50-T-Y (1/26) annual rate schedule: 3.9%, 4.4%, 5.15%, 5.4%, 5.9%.",
                      "Taxable income is income less the state standard deduction and personal exemptions for single; credits and federal-tax deductions are not modelled.",
                      "Estimated rates, mostly tax year 2026 (California uses the 2025 schedule; see the per-state note). Check your state's revenue department for exact figures.",
                      "..."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Neither state nor ratePct, an unknown state (the message says what to send), a negative income, an unknown filingStatus, or a locality that does not belong to the state Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/business/pay-stub": {
      "post": {
        "summary": "Generate a pay stub with gross pay, deductions and net pay",
        "operationId": "businessPayStub",
        "description": "Generate a pay stub with gross pay, deductions and net pay. Send JSON with employer, employee, periodStart, periodEnd, payDate, payType, rate (required); optional: hours, overtimeHours, otMultiplier, bonus, fedPct, statePct, ssPct, medPct, health, retire, other, ytdGross, employerAddress, employeeId. Returns JSON with figures, document (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "employer": {
                    "type": "string",
                    "minLength": 1
                  },
                  "employee": {
                    "type": "string",
                    "minLength": 1
                  },
                  "periodStart": {
                    "type": "string",
                    "minLength": 1
                  },
                  "periodEnd": {
                    "type": "string",
                    "minLength": 1
                  },
                  "payDate": {
                    "type": "string",
                    "minLength": 1
                  },
                  "payType": {
                    "type": "string",
                    "enum": [
                      "hourly",
                      "salary"
                    ]
                  },
                  "rate": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Hourly rate, or the salary for this period"
                  },
                  "hours": {
                    "type": "string"
                  },
                  "overtimeHours": {
                    "type": "string"
                  },
                  "otMultiplier": {
                    "type": "string"
                  },
                  "bonus": {
                    "type": "string"
                  },
                  "fedPct": {
                    "type": "string"
                  },
                  "statePct": {
                    "type": "string"
                  },
                  "ssPct": {
                    "type": "string"
                  },
                  "medPct": {
                    "type": "string"
                  },
                  "health": {
                    "type": "string"
                  },
                  "retire": {
                    "type": "string"
                  },
                  "other": {
                    "type": "string"
                  },
                  "ytdGross": {
                    "type": "string"
                  },
                  "employerAddress": {
                    "type": "string"
                  },
                  "employeeId": {
                    "type": "string"
                  }
                },
                "required": [
                  "employer",
                  "employee",
                  "periodStart",
                  "periodEnd",
                  "payDate",
                  "payType",
                  "rate"
                ],
                "additionalProperties": false
              },
              "example": {
                "employer": "Northwind Design LLC",
                "employee": "Maria Lopez",
                "periodStart": "2026-10-01",
                "periodEnd": "2026-10-15",
                "payDate": "2026-10-20",
                "payType": "hourly",
                "rate": "28.50",
                "hours": "80",
                "overtimeHours": "4",
                "fedPct": "12",
                "statePct": "4",
                "ssPct": "6.2",
                "medPct": "1.45",
                "health": "85"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Pay stub generator client and server side from freedailypro",
                  "result": {
                    "figures": {
                      "regular": 2280,
                      "overtime": 171,
                      "bonus": 0,
                      "gross": 2451,
                      "deductions": [
                        {
                          "label": "Federal income tax",
                          "amount": 294.12
                        },
                        {
                          "label": "State income tax",
                          "amount": 98.04
                        },
                        {
                          "label": "Social Security",
                          "amount": 151.96
                        },
                        "..."
                      ],
                      "totalDeductions": 664.66,
                      "net": 1786.34,
                      "regularHours": 80,
                      "overtimeHours": 4
                    },
                    "document": {
                      "title": "Pay Stub",
                      "sections": [
                        {
                          "paragraphs": [
                            "Employer: Northwind Design LLC",
                            "Employee: Maria Lopez",
                            "Pay period: 2026-10-01 to 2026-10-15",
                            "..."
                          ]
                        },
                        {
                          "heading": "Earnings",
                          "paragraphs": [
                            "Regular pay (80 h at $28.50): $2,280.00",
                            "Overtime (4 h): $171.00",
                            "Gross pay: $2,451.00"
                          ]
                        },
                        {
                          "heading": "Deductions",
                          "paragraphs": [
                            "Federal income tax: -$294.12",
                            "State income tax: -$98.04",
                            "Social Security: -$151.96",
                            "..."
                          ]
                        },
                        "..."
                      ],
                      "filename": "pay-stub-maria-lopez-2026-10-20.docx"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    }
  }
}