Calculate Social Security taxes

1 min

POST

https://osifinance.com/api/v1/social-security-taxes

Body Parameters

bodyobjectrequired
Description
Parameters for calculating Social Security taxes
- api_keyApiKeyrequired
  Description
  API key needed to authorize requests
- filing_statusFilingStatus
  Description
  Filing status for taxes.
  Default
  single
- pmiPmi
  Description
  Monthly Social Security benefits.
  Default
  0
- incomeIncome
  Description
  Gross income.
  Default
  100000
- federal_agiFederalAgi
  Description
  Federal adjusted gross income (agi).
  Default
  75000
- federal_deductionsFederalDeductions
  Description
  Cumulative federal deductions, either standard or itemized.
  Default
  0
- state_agiStateAgi
  Description
  State adjusted gross income (agi).
  Default
  0
- credits_federalCreditsFederal
  Description
  Federal tax credits.
  Default
  0
- credits_stateCreditsState
  Description
  State tax credits.
  Default
  0
- capital_gains_shortCapitalGainsShort
  Description
  Short term capital gains.
  Default
  0
- state_residenceStateResidence
  Description
  State of residence.
  Default
  Florida
- state_occupationStateOccupation
  Description
  State of occupation.
  Default
  Florida
- county_residenceCountyResidence
  Description
  County of residence.
  Default
  Other
- county_occupationCountyOccupation
  Description
  County of occupation.
  Default
  Other
- dependentsDependents
  Description
  Number of dependents.
  Default
  0
- birth_yearBirthYear
  Description
  Year of birth.
  Default
  1990
- filersOver65FilersOver65
  Description
  Number of filers over 65.
  Default
  0
- traditional_esp_contributionsTraditionalEspContributions
  Description
  Traditional employer sponsored plan contributions (401(k), 429(b), 457(b)).
  Default
  0
- traditional_ira_contributionsTraditionalIraContributions
  Description
  Traditional IRA contributions.
  Default
  0

Responses

200OK

object
- statusstring<success>
  Description
  Success message
- dataobject
  - Tax Typeobject
    Description
    List of tax types
  - Marginal Tax Rateobject
    Description
    Marginal tax rate for each tax type
  - Effective Tax Rateobject
    Description
    Effective tax rate for each tax type
  - 2023 Taxesobject
    Description
    2023 taxes for each tax type
- sourcesobject
  Description
  List of sources

400Bad request

object
- errorstring
  Description
  Error message

401Unauthorized

object
- errorstring<No API key provided. Please provide an API Key. | Invalid API key provided. Please register at https://osifinance.com/signup to get a valid API key.>
  Description
  Error message

404Not found

object
- errorstring
  Description
  Error message

429Too Many Requests

object
- errorstring<Usage Limit Reached. You have reached the maximum number of daily requests for your account. You can get a higher limit by upgrading to a paid plan or through our give2get program. Learn more at https://osifinance.com/resources/help/give2get?question=How%20can%20I%20get%20free,%20unlimited%20access%20to%20the%20API%20and%20calculators?.>
  Description
  Error message

500Internal server error

object
- errorstring
  Description
  Error message

curl

curl --request POST \
     --url https://osifinance.com/api/v1/social-security-taxes \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "api_key": "",
     "filing_status": "single",
     "income": 100000,
     "federal_agi": 75000,
     "state_residence": "Florida",
     "state_occupation": "Florida",
     "county_residence": "Other",
     "county_occupation": "Other",
     "birth_year": 1990
     }'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var raw = JSON.stringify({
   "api_key": "",
   "filing_status": "single",
   "income": 100000,
   "federal_agi": 75000,
   "state_residence": "Florida",
   "state_occupation": "Florida",
   "county_residence": "Other",
   "county_occupation": "Other",
   "birth_year": 1990
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://osifinance.com/api/v1/social-security-taxes", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://osifinance.com/api/v1/social-security-taxes")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "api_key": "",
   "filing_status": "single",
   "income": 100000,
   "federal_agi": 75000,
   "state_residence": "Florida",
   "state_occupation": "Florida",
   "county_residence": "Other",
   "county_occupation": "Other",
   "birth_year": 1990
})

response = https.request(request)
puts response.read_body

python

import requests
import json

url = "https://osifinance.com/api/v1/social-security-taxes"

payload = json.dumps({
   "api_key": "",
   "filing_status": "single",
   "income": 100000,
   "federal_agi": 75000,
   "state_residence": "Florida",
   "state_occupation": "Florida",
   "county_residence": "Other",
   "county_occupation": "Other",
   "birth_year": 1990
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

200

// OK
{
  "status": "",
  "data": {
    "Tax Type": {},
    "Marginal Tax Rate": {},
    "Effective Tax Rate": {},
    "2023 Taxes": {}
  },
  "sources": {}
}

400

// Bad request
{
  "error": ""
}

401

// Unauthorized
{
  "error": ""
}

404

// Not found
{
  "error": ""
}

429

// Too Many Requests
{
  "error": ""
}

500

// Internal server error
{
  "error": ""
}