Holiday Sale! Get over 30% off when you subscribe to an annual plan!

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
314ms348ms392ms580ms1081ms

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

  • 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

  • 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

    Social Security tax amount - US only.

  • fica_medicare

    Medicare tax amount - US only.

  • fica_total

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

  • region_effective_rate

    Effective state/provincial tax rate as a decimal.

  • region_taxes_owed

    Total state/provincial taxes owed.

  • total_taxes_owed

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

  • income_after_tax

    Income remaining after all taxes.

  • total_effective_tax_rate

    Overall effective tax rate as a decimal.

Sample Request Live Demo!

country
region
income
filing_status
deductions

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

Headers

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

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 { "country": "US", "region": "CA", "income": 100000, "taxable_income": 100000, "deductions": 0, "credits": 0, "federal_effective_rate": 0.17053, "federal_taxes_owed": 17053, "fica_social_security": 6200, "fica_medicare": 1450, "fica_total": 7650, "region_effective_rate": 0.05952849999999999, "region_taxes_owed": 5952.849999999999, "total_taxes_owed": 30655.85, "income_after_tax": 69344.15, "total_effective_tax_rate": 0.3065585 }

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/incometaxcalculator?country=US&region=CA&income=100000&filing_status=single" \ -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.