Introduction
Welcome to the Global Automotives Cloud API! You can use our API to access Vehicle API endpoints, which can get information on vehicle based on registration/plate number in our database.
We have language bindings in Shell and PHP! You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.
If you have any question or feedback, you are feel free to contact Automotives Cloud or send e-mail to global@automotivescloud.com.
Authentication
To authorize, use this code:
# With shell, you can just pass the correct header with each request
curl "api_endpoint_here" \
-H "Authorization: Bearer API_TOKEN"
-H "Accept: application/json"
Make sure to replace
API_TOKEN
with your API token.
Global Automotives Cloud uses API tokens to allow access to the API. You will get API TOKEN on Global Automotives Cloud.
Global Automotives Cloud expects for the API Token and Accept type to be included in all API requests to the server in a header that looks like the following:
Authorization: Bearer API_TOKEN
Accept: application/json
Vehicle
Get vehicle by registration/plate number
// You will get api token here https://global.automotivescloud.com/my-account/settings
$api_token = '<API TOKEN>';
$data = [
'registration_no' => 'Eg258ma',
'country_code' => 'fr'
];
$url = "https://global.automotivescloud.com/api/v1/vehicle?" . http_build_query($data);
$ch = curl_init();
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer '. $api_token,
'Accept: application/json'
]
);
//Get the response from cURL
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_URL, $url);
$result = json_decode(curl_exec($ch), true);
$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if($httpcode != 200){
// on Error
echo $result['message'];
}
else{
// On Success
echo '<pre>'; print_r($result); echo '</pre>';
}
curl "https://global.automotivescloud.com/api/v1/vehicle" \
-H "Authorization: Bearer API_TOKEN"
-H "Accept: application/json"
-d "country_code={country_code}"
-d "registration_no={registration_no}"
You must replace
{country_code}
with two character country code and{registration_no}
with your real registration/plate number. The above command returns JSON structured (Country wise vehicle data can be different) like this:
{
"data": {
// Available data should be here...
}
}
This endpoint retrieves registration details of vehicle.
HTTP Request
GET https://global.automotivescloud.com/api/v1/vehicle
Query Parameters
Parameter | Default | Description |
---|---|---|
registration_no | Charge will be taken on each success call. For free testing you have to use predefined registration number based on country. Please see Free Registration Number | |
country_code | fr | Please see Available Countries |
Return
On success you will get details of vehicle as per country. Please see available data based on country. If you have error please see errors section for details.
Available Countries
Right now we are supporting only two countries. More are coming soon. If you have any request, please let us know.
Countries List
Country Code | Description |
---|---|
fr | France |
it | Italy |
Free Registration Number
Following registration number is only for testing. We will not take charge if you use these numbers. Otherwise, you will be charged on each call.
Registration/plate number
Country Code | Registration Number | Description |
---|---|---|
fr | Eg258ma | |
it | BN071VN |
Available Data Based on Country
France
{
"data": {
"VIN": "VF1JZ890H55864144",
"RegistrationDate": "2016-06-24",
"RegistrationYear": "2016",
"FirstRegistrationDate": "24062016",
"FirstManufacturingYear": "2016",
"Make": "RENAULT",
"MakeCode": "RE",
"MakeDescription": "RENAULT",
"Model": "SCÉNIC III",
"ModelCode": "",
"ModelDescription": "SCÉNIC III",
"Description": "RENAULT SCÉNIC III",
"EngineSize": "5",
"FuelType": "DIESEL",
"FuelTypeCode": "D",
"Immobiliser": "",
"IndicativeValue": 0,
"DriverSide": "",
"BodyStyle": "MONOSPACE COMPACT",
"BodyVersionCode": "",
"BodyCode": "",
"ImageUrl": "http://immatriculationapi.com/image.aspx/@UkVOQVVMVCBTQ8OJTklDIElJSQ==",
"Transmission": "MECANIQUE",
"Version": "1.5 dCi 1461cm3 110cv ",
"SafetyClassification": "",
"ProductCode": "",
"SeatNumber": "5",
"BatteryIssues": "",
"ElectricVehicle": "",
"ValueAsNew": "",
"RiskLevel": "",
"ManufacturerProtection": "",
"DynamicPower": "110",
"SegmentCode": "",
"KtypeId": "5853",
"EngineCC": "1461",
"Co2": "105",
"Cylinders": "4",
"CNIT": "M10RENVP472E768",
"Type": "VP",
"TypeCode": "",
"TypeAsEuropeanClassification": "Passenger Car",
"TypeCodeAsEuropeanClassification": [
"M1"
]
}
}
Registration details of France
Field | Type | Description |
---|---|---|
VIN | string | |
RegistrationDate | string | |
RegistrationYear | string | |
FirstRegistrationDate | string | |
FirstManufacturingYear | string | |
Make | string | |
MakeCode | string | |
MakeDescription | string | |
Model | string | |
ModelCode | string | |
ModelDescription | string | |
Description | string | |
EngineSize | string | |
FuelType | string | |
FuelTypeCode | string | |
Immobiliser | string | |
IndicativeValue | string | |
DriverSide | string | |
BodyStyle | string | |
BodyVersionCode | string | |
BodyCode | string | |
ImageUrl | string | |
Transmission | string | |
Version | string | |
SafetyClassification | string | |
ProductCode | string | |
SeatNumber | string | |
BatteryIssues | string | |
ElectricVehicle | string | |
ValueAsNew | string | |
RiskLevel | string | |
ManufacturerProtection | string | |
DynamicPower | string | |
SegmentCode | string | |
KtypeId | string | |
EngineCC | string | |
Co2 | string | |
Cylinders | string | |
CNIT | string | |
Type | string | As French Classification |
TypeCode | string | As French Classification |
TypeAsEuropeanClassification | string | |
TypeCodeAsEuropeanClassification | array | Frech classification is mapped with European Calssification according to this this documentation https://www.carte-grise.org/docs/Liste-Genres-et-Energies_12-06-2009.pdf |
Italy
{
"data": {
"VIN": "",
"RegistrationYear": "2000",
"Description": "Peugeot 206",
"Make": "Peugeot",
"MakeDescription": "Peugeot",
"Model": "206",
"ModelDescription": "206",
"EngineSize": "14 cv (da 1119,2 a 1243,6 cc.)",
"FuelType": "Benzina",
"Immobiliser": "",
"ImageUrl": "http://www.targa.co.it/image.aspx/@UGV1Z2VvdCAyMDY=",
"NumberOfDoors": "",
"Version": "206 1.1 3p. Xr (08-2000)",
"ABS": "N",
"AirBag": "S",
"KType": "",
"PowerCV": "",
"PowerKW": "",
"PowerFiscal": ""
}
}
Registration details of Italy
Field | Type | Description |
---|---|---|
VIN | string | |
RegistrationYear | string | |
Description | string | |
Make | string | |
MakeDescription | string | |
Model | string | |
ModelDescription | string | |
EngineSize | string | |
FuelType | string | |
Immobiliser | string | |
ImageUrl | string | |
NumberOfDoors | string | |
Version | string | |
ABS | string | |
AirBag | string | |
KType | string | |
PowerCV | string | |
PowerKW | string | |
PowerFiscal | string |
Errors
The Global Automotives Cloud API uses the following error codes:
Error Code | Meaning |
---|---|
206 | No Result -- Based on your request we cannot find the record in our registration database. |
400 | Bad Request -- Your request is invalid. |
401 | Unauthorized -- Your API key is wrong. |
404 | Not Found -- The specified endpoint or query param could not be found. |
406 | Not enough credit -- You have not enough credit to call. |
422 | Invalid entity -- Your provided data is not correct format. |
500 | Internal Server Error -- We had a problem with our server. Try again later. |
503 | Maintenance Mode -- We're upgrading the system, will be back soon. |
512 | Internal pricing error. Please contact us, if this error persists. |
513 | Internal registration database has been disconnected. Please contact us, if such error persists. |