Provides the basic starting price for an electric car, along with the amount of any plug-in vehicle grant available for the vehicle. Pricing is based on the cheapest variant with the same powertrain and more expensive versions or trim levels may be available.
Key Features
Basic Price
The basic price including any plug-in grants and VAT
P11D Value
The value of the vehicle for P11D purposes used when calculating benefit-in-kind tax
Plug-in Vehicle Grant
The amount of any plug-in vehicle grant available
BIK Rate
The percentage rate used to calculate BIK in the current tax year
BIK Amount
The benefit-in-kind in GBP based on the P11D value and BIK Rate
Marginal Tax Rates
Used to calculate BIK tax payable
Sample Response
V1
Documentation
Introduction
This endpoint returns basic starting price and the amount of any plug-in vehicle grant available for an electric car.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/evdatabase/uk/car/pricinggrantstaxes/?evdb_vehicle_id=1234
Example Sandbox Request
https://sandbox.oneautoapi.com/evdatabase/uk/car/pricinggrantstaxes/?evdb_vehicle_id=1234
Request Parameters
evdb_vehicle_id
mandatory, string, e.g. 1234
EV Database Vehicle ID
Sample Response
{
"success": true,
"result": {
"price_inc_grants_from": 59990,
"p11d_price_from": 59935,
"is_pricing_estimated": false,
"plug_in_vehicle_grant": 5000,
"benefit_in_kind_year": "2023-24",
"benefit_in_kind_percentage_charge": 2,
"benefit_in_kind_gbp": 1199,
"benefit_in_kind_per_annum_basic_rate_gbp": 20,
"benefit_in_kind_per_annum_higher_rate_gbp": 40,
"benefit_in_kind_per_annum_additional_rate_gbp": 45
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
price_inc_grants_from
e.g. 59990
Starting price based on OTR for the local market. Includes VAT, fees with any applicable grants deducted
p11d_price_from
e.g. 59935
P11D value based on starting price
is_pricing_estimated
e.g. false
Is pricing estimated
plug_in_vehicle_grant
e.g. 5000
The amount of any plug-in car grant available for this vehiclet
benefit_in_kind_year
e.g. 2023-24
The fiscal year on which benefit in kind data is based
benefit_in_kind_percentage_charge
e.g. 2
The percentage of the P11D values based on the vehicle's CO2
benefit_in_kind_gbp
e.g. 1199
Benefit in kind amount in GBP
benefit_in_kind_per_annum_basic_rate_gbp
e.g. 20
Basic rate benefit in kind per annum
benefit_in_kind_per_annum_higher_rate_gbp
e.g. 40
Higher rate benefit in kind per annum
benefit_in_kind_per_annum_additional_rate_gbp
e.g. 45
Additional rate benefit in kind per annum
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