Taxi Check
Identify Hackney & Private Hire History from Licensing Authorities.
This check uses data carefully sourced from licensing authorities around the UK, cross referenced with plate change history for the accurate identification of previously licensed Hackney Carriages and Private Hire Vehicles.
The check provides valuable protection for consumers and the trade when buying used vehicles and ensures compliance with trading standards obligations in relation to previous use.
Key Features
VRM-based Lookup
Easily identify taxi history by registration mark
Includes Plate Changes
Cross referenced with plate changes to maximise coverage
Licensing Authority
Tells you where the vehicle has been licensed as a taxi
Licence Type
Whether the vehicle was licensed for Private Hire or as a Hackney Carriage
Licence Periods
Start and end dates for each period during which the vehicle was licensed as a taxi
Licence Holder Name
Identifies who licensed the vehicle (where disclosed)
Sample Response
V2
Documentation
Introduction
This endpoint returns a true/false identifier confirming whether the vehicle has been used as a taxi or private hire vehicle. If the vehicle has been previously used as a taxi or private hire vehicle, then make, model, fuel type, licence start & end date, whether the vehicle is wheelchair adapted and licence holder name is also returned.
Header
When making calls to our API, include the following header:
x-api-key:your-api-key-here
Example Request
https://api.oneautoapi.com/carguide/taxicheck?vehicle_registration_mark=AB21ABC
Example Sandbox Request
https://sandbox.oneautoapi.com/carguide/taxicheck?vehicle_registration_mark=AB21ABC
Request Parameters
vehicle_registration_mark
mandatory, string, e.g. AB21ABC
Vehicle registration number
Sample Response
{
"success": true,
"result": {
"is_possible_taxi": true,
"possible_taxi_reason": "Taxi licence records",
"taxi_records": [
{
"taxi_record_id": 123456,
"manufacturer_desc": "MAZDA",
"model_range_desc": "6 SE-L NAV D AUTO",
"manufacturer_model_desc": "Mazda 6",
"licence_authority": "TFL",
"licence_start_date": "2020-01-01",
"licence_expiry_date": "2020-01-01",
"is_wheelchair_adapted": false,
"carguide_fuel_type_desc": "Petrol",
"licence_holder_name": "null"
}
]
},
"error": "If there is an error the message would go here"
}Response Parameters
success
e.g. true
Whether the api call was successful
is_possible_taxi
e.g. true
Has the vehicle been previously used as a taxi.
possible_taxi_reason
e.g. Taxi licence records
The reason for the possible taxi status.
taxi_record_id
e.g. 123456
The taxi record ID.
manufacturer_desc
e.g. MAZDA
Manufacturer description
model_range_desc
e.g. 6 SE-L NAV D AUTO
Model range description.
manufacturer_model_desc
e.g. Mazda 6
The model range description.
licence_authority
e.g. TFL
Licence authority
licence_start_date
e.g. 2020-01-01
The taxi and private hire licence start date.
licence_expiry_date
e.g. 2020-01-01
The taxi and private hire licence expiry date.
is_wheelchair_adapted
e.g. false
Is the vehicle wheelchair adapated.
carguide_fuel_type_desc
e.g. Petrol
The fuel type
licence_holder_name
e.g. null
This field has been deprecated and will always return null.
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