Company Car Tax Calculator
Provides vital information on payroll impact to company car drivers, or those considering a salary sacrifice arrangement.
Easily integrated in apps and websites, with no on-going maintenance overhead - provides and fast and cost effective solution to providing company car tax information.
Key Features
Banded Tax Costs
Provides a simple view for each marginal tax rate
Earnings-based Calculation
Personalised earnings-based calculation
Compatible
Integrates easily with your existing data landscape
Scottish Tax Rates
Includes support for Scottish income tax rates and thresholds
Capital Contributions
Calculate the impact of capital contributions
Private Use Contributions
Understand the impact of contributions for private use
Sample Response
V2
Documentation
Introduction
This endpoint returns the percentage charge, benefit-in-kind (BIK) and additional monthly tax calculation.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/companycar/tax?co2_gkm=23&list_price_inc_options_delivery_vat=37200&zero_emission_mileage=45&capital_contribution=3000&contribution_toward_private_use_per_annum=1000&annual_earnings=48000&scottish_tax_payer=true
Example Sandbox Request
https://sandbox.oneautoapi.com/companycar/tax?co2_gkm=23&list_price_inc_options_delivery_vat=37200&zero_emission_mileage=45&capital_contribution=3000&contribution_toward_private_use_per_annum=1000&annual_earnings=48000&scottish_tax_payer=true
Request Parameters
co2_gkm
mandatory, string, e.g. 23
CO2 in g/km
list_price_inc_options_delivery_vat
mandatory, string, e.g. 37200
List price + options + delivery price including VAT
zero_emission_mileage
mandatory, string, e.g. 45
Maximum distance in miles that can be driven in electric mode without recharging the battery
capital_contribution
optional, string, e.g. 3000
The payments the employee makes towards the cost of the car or qualifying accessories
contribution_toward_private_use_per_annum
optional, string, e.g. 1000
The payment the employee makes towards the car to allow them to use the vehicle for private purposes
annual_earnings
optional, string, e.g. 48000
Employee's annual earnings before tax
scottish_tax_payer
mandatory, string, e.g. true
Is the employee at Scottish tax payer i.e. true, false
Sample Response
{
"success": true,
"result": {
"percentage_charge": {
"percentage_charge_Y1": 12,
"percentage_charge_Y2": 12,
"percentage_charge_Y3": 12,
"percentage_charge_Y4": 12,
"percentage_charge_Y5": 12
},
"benefit_in_kind_per_annum": {
"benefit_in_kind_per_annum_Y1": "1234.50",
"benefit_in_kind_per_annum_Y2": "1234.50",
"benefit_in_kind_per_annum_Y3": "1234.50",
"benefit_in_kind_per_annum_Y4": "1234.50",
"benefit_in_kind_per_annum_Y5": "1234.50"
},
"calculated_tax_per_month": {
"calculated_tax_per_month_Y1": 123.45,
"calculated_tax_per_month_Y2": 123.45,
"calculated_tax_per_month_Y3": 123.45,
"calculated_tax_per_month_Y4": 123.45,
"calculated_tax_per_month_Y5": 123.45
},
"banded_tax_per_month": {
"Y1": [
{
"percentage_tax_rate": 20,
"tax_per_month": 123
},
{
"percentage_tax_rate": 40,
"tax_per_month": 234
},
{
"percentage_tax_rate": 45,
"tax_per_month": 456
}
],
"Y2": [
{
"percentage_tax_rate": 20,
"tax_per_month": 123
},
{
"percentage_tax_rate": 40,
"tax_per_month": 234
},
{
"percentage_tax_rate": 45,
"tax_per_month": 456
}
],
"Y3": [
{
"percentage_tax_rate": 20,
"tax_per_month": 123
},
{
"percentage_tax_rate": 40,
"tax_per_month": 234
},
{
"percentage_tax_rate": 45,
"tax_per_month": 456
}
],
"Y4": [
{
"percentage_tax_rate": 20,
"tax_per_month": 123
},
{
"percentage_tax_rate": 40,
"tax_per_month": 234
},
{
"percentage_tax_rate": 45,
"tax_per_month": 456
}
],
"Y5": [
{
"percentage_tax_rate": 20,
"tax_per_month": 123
},
{
"percentage_tax_rate": 40,
"tax_per_month": 234
},
{
"percentage_tax_rate": 45,
"tax_per_month": 456
}
]
}
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
percentage_charge_Y1
e.g. 12
The percentage_charge for year one.
percentage_charge_Y2
e.g. 12
The percentage_charge for year two.
percentage_charge_Y3
e.g. 12
The percentage_charge for year three.
percentage_charge_Y4
e.g. 12
The percentage_charge for year four.
percentage_charge_Y5
e.g. 12
The percentage_charge for year fifth.
benefit_in_kind_per_annum_Y1
e.g. 1234.50
The benefit in kind (the valuation of the vehicle for tax purposes for each tax year ) for the first year .
benefit_in_kind_per_annum_Y2
e.g. 1234.50
The benefit in kind (the valuation of the vehicle for tax purposes for each tax year ) for the second year .
benefit_in_kind_per_annum_Y3
e.g. 1234.50
The benefit in kind (the valuation of the vehicle for tax purposes for each tax year ) for the third year .
benefit_in_kind_per_annum_Y4
e.g. 1234.50
The benefit in kind (the valuation of the vehicle for tax purposes for each tax year ) for the fourth year .
benefit_in_kind_per_annum_Y5
e.g. 1234.50
The benefit in kind (the valuation of the vehicle for tax purposes for each tax year ) for the fifth year .
calculated_tax_per_month_Y1
e.g. 123.45
The calculated tax per month in the first year.
calculated_tax_per_month_Y2
e.g. 123.45
The calculated tax per month in the second year.
calculated_tax_per_month_Y3
e.g. 123.45
The calculated tax per month in the third year.
calculated_tax_per_month_Y4
e.g. 123.45
The calculated tax per month in the forth year.
calculated_tax_per_month_Y5
e.g. 123.45
The calculated tax per month in the fifth year.
percentage_tax_rate
e.g. 20
The percentage tax rate.
tax_per_month
e.g. 123
The tax per month.
percentage_tax_rate
e.g. 40
The percentage tax rate.
tax_per_month
e.g. 234
The tax per month.
percentage_tax_rate
e.g. 45
The percentage tax rate.
tax_per_month
e.g. 456
The tax per month.
percentage_tax_rate
e.g. 20
The percentage tax rate.
tax_per_month
e.g. 123
The tax per month.
percentage_tax_rate
e.g. 40
The percentage tax rate.
tax_per_month
e.g. 234
The tax per month.
percentage_tax_rate
e.g. 45
The percentage tax rate.
tax_per_month
e.g. 456
The tax per month.
percentage_tax_rate
e.g. 20
The percentage tax rate.
tax_per_month
e.g. 123
The tax per month.
percentage_tax_rate
e.g. 40
The percentage tax rate.
tax_per_month
e.g. 234
The tax per month.
percentage_tax_rate
e.g. 45
The percentage tax rate.
tax_per_month
e.g. 456
The tax per month.
percentage_tax_rate
e.g. 20
The percentage tax rate.
tax_per_month
e.g. 123
The tax per month.
percentage_tax_rate
e.g. 40
The percentage tax rate.
tax_per_month
e.g. 234
The tax per month.
percentage_tax_rate
e.g. 45
The percentage tax rate.
tax_per_month
e.g. 456
The tax per month.
percentage_tax_rate
e.g. 20
The percentage tax rate.
tax_per_month
e.g. 123
The tax per month.
percentage_tax_rate
e.g. 40
The percentage tax rate.
tax_per_month
e.g. 234
The tax per month.
percentage_tax_rate
e.g. 45
The percentage tax rate.
tax_per_month
e.g. 456
The tax per month.
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call
Status Codes
200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com