UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

Company Car Tax Calculator

UK BIK Calculation with Scottish Rates & Salary Sacrifice Support

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

Pricing

PAYG
50p
Per Use
Business
25p
Per Use
Enterprise
15p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)50p60c70c
Business (Per Use)25p30c35c
Enterprise (Per Use)15p18c21c

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

Also Available From One Auto API

Company Car Tax Calculator

Calculate UK BIK and company car tax via a single API. Banded costs, personalised calculations, Scottish rates and capital contributions supported.

Insurance Rates

Provides benchmark UK vehicle insurance rates based on group, fuel type and age. Suitable for car comparisons and running cost analysis.

Lead Validation

Identify leads that require special handling and drive efficiencies in the downstream sales process. Pay on results for guaranteed ROI.

License Plate to VIN (US)

Access License Plate to VIN lookups with one API endpoint for all 50 US states, including make, model, trim decode.

MOT History & Tax Status

MOT history and current UK vehicle tax status via a single API. Combined DVLA and DVSA data by VRM - covers test results, refusals and advisories.