Income Tax Calculator API

The Income Tax Calculator API calculates detailed tax information based on income, location, and filing status using the latest tax rates.

Currently this API supports United States (including state income tax and FICA) and Canada (including provincial income tax). If you would like to see other countries added, please let us know.

Only interested in getting current and historical income tax rates? Check out our Income Tax API.

(4.5)

From 2,366 users

1,000+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
323ms346ms371ms619ms1054ms

Didn't find what you were looking for? Suggest an improvement

/v1/incometaxcalculator GET

https://api.api-ninjas.com/v1/incometaxcalculator

Returns comprehensive tax calculations including federal, state/provincial, and FICA taxes where applicable.

Parameters

  • country  required

    2-letter country code (e.g., US, CA)

  • region  required

    State/province code (e.g., CA, NY, ON)

  • income  required

    Annual income amount

  • tax_year  optional

    Tax year in YYYY format (e.g., 2026). If not specified, the latest year will be used.

  • filing_status  required for US

    Tax filing status. Possible values: single, married (married filing jointly), married_separate (married filing separately), or head_of_household

  • deductions  optional

    Total tax deductions amount

  • credits  optional

    Total tax credits amount

  • self_employed  optional

    Set to true for self-employed tax calculations (US only)

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • country

    The country code used in the calculation.

  • region

    The state/province code used in the calculation.

  • income

    The annual income amount.

  • taxable_income

    Income after deductions.

  • deductions

    Total deductions applied.

  • credits

    Total tax credits applied.

  • federal_effective_rate

    Effective federal tax rate as a decimal.

  • federal_taxes_owed

    Total federal taxes owed.

  • fica_social_security premium only

    Social Security tax amount - US only.

  • fica_social_security_rate premium only

    Social Security tax rate as a decimal - US only.

  • fica_social_security_cap premium only

    Social Security wage base cap - US only.

  • fica_medicare premium only

    Medicare tax amount - US only.

  • fica_medicare_rate premium only

    Medicare tax rate as a decimal - US only.

  • fica_total premium only

    Total FICA taxes (Social Security + Medicare taxes) - US only.

  • region_effective_rate premium only

    Effective state/provincial tax rate as a decimal.

  • region_taxes_owed premium only

    Total state/provincial taxes owed.

  • total_taxes_owed premium only

    Total taxes owed (federal + state/provincial + FICA).

  • income_after_tax premium only

    Income remaining after all taxes.

  • total_effective_tax_rate premium only

    Overall effective tax rate as a decimal.

Sample Request Live Demo!

country
region
income
tax_year
filing_status

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/incometaxcalculator?country=US&region=CA&income=100000&filing_status=single&tax_year=2026

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/incometaxcalculator?country=US&region=CA&income=100000&filing_status=single&tax_year=2026" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.