VIN Decoder API

<?php
// API data
$api_uid = "USERID"; // Enter your API UID
$api_key = "APIKEY"; // Enter your API Key
// VIN to be entered
$vin = "VINNUMBER"; // Enter the VIN number
// Preferred language for API response
$lang = "en"; // Set the preferred language, e.g., 'en' for English etc.
// Generating checksum as MD5
$checksum = md5($api_uid . $api_key . $vin);
// API URL with language parameter
$url = "https://bp.autoiso.pl/api/v3/getDecoderFree/apiuid:$api_uid/checksum:$checksum/vin:$vin/lang:$lang";
// Initializing cURL session
$ch = curl_init();
// cURL settings
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // Get the response as a variable
curl_setopt($ch, CURLOPT_HTTPGET, true);
// Execute the request
$response = curl_exec($ch);
// Check if an error occurred
if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    echo "API response:\n";
    echo $response;
    $responseData = json_decode($response, true);
    print_r($responseData);
}
// Close the cURL session
curl_close($ch);
?>

{
  "analyze": {
    "vin_orginal": {
      "desc": "Entered VIN",
      "value": "U5YFF24428L068330"
    },
    "vin_corrected": {
      "desc": "Corrected VIN",
      "value": "U5YFF24428L068330"
    },
    "vin_year": {
      "desc": "Year Identifier",
      "value": "8"
    },
    "vin_serial": {
      "desc": "Serial number",
      "value": "068330"
    },
    "checkdigit": {
      "desc": "Check Digit",
      "value": "not applicable"
    }
  },
  "manufacturer": {
    "name": {
      "desc": "Manufacturer",
      "value": "KIA Motors Slovakia s.r.o."
    },
    "adress_1": {
      "desc": "Adress #1",
      "value": "Maranske namestie 30/5"
    },
    "adress_2": {
      "desc": "Adress #2",
      "value": "010 01 Zilina"
    },
    "region": {
      "desc": "Region",
      "value": "Europe"
    },
    "country": {
      "desc": "Country",
      "value": "Slovakia"
    },
    "note": {
      "desc": "Note",
      "value": "Manufacturer builds more than 500 vehicles per year"
    }
  },
  "decoder": {
    "make": {
      "desc": "Make",
      "value": "Kia"
    },
    "model": {
      "desc": "Model",
      "value": "Ceed"
    },
    "model_year": {
      "desc": "Model year",
      "value": "2007"
    },
    "body": {
      "desc": "Body type",
      "value": "Hatchback"
    },
    "fuel_type": {
      "desc": "Fuel type",
      "value": "Diesel"
    },
    "vehicle_type": {
      "desc": "Vehicle type",
      "value": "Passenger Vehicle"
    },
    "doors": {
      "desc": "Doors number",
      "value": "5"
    },
    "engine_displ_cm3": {
      "desc": "Displacement SI",
      "value": "1582 cm3"
    },
    "engine_displ_l": {
      "desc": "Displacement Nominal",
      "value": "1.6 l"
    },
    "engine_power_hp": {
      "desc": "Horsepower",
      "value": "115 HP"
    },
    "engine_power_kw": {
      "desc": "Kilowatts",
      "value": "84 kW"
    }
  },
  "custom_equipment": {
    "desc": "Custom equipment list",
    "values": [
      {
        "code": "6142",
        "value": "ABS BRAKES"
      },
      {
        "code": "6144",
        "value": "RADIO RECEIVER"
      }
    ]
  }
}

openapi: 3.0.0
info:
  title: VIN Decoder API
  version: '1.0'
  description: API to decode VIN and obtain vehicle information.
servers:
  - url: https://bp.autoiso.pl/api/v3
paths:
  /getDecoderFree/apiuid:{apiuid}/checksum:{checksum}/vin:{vin}/lang:{lang}:
    get:
      summary: Decoding the VIN number
      parameters:
        - name: apiuid
          in: path
          required: true
          description: Unique API user identifier
          schema:
            type: string
        - name: checksum
          in: path
          required: true
          description: MD5 checksum (apiuid + api_key + VIN)
          schema:
            type: string
        - name: vin
          in: path
          required: true
          description: Vehicle Identification Number (VIN) for decoding
          schema:
            type: string
        - name: lang
          in: path
          required: true
          description: Response language code
          schema:
            type: string
      responses:
        '200':
          description: The response contains decoded vehicle information.
          content:
            application/json:
              schema:
                type: object
                properties:
                  analyze:
                    type: object
                  manufacturer:
                    type: object
                  decoder:
                    type: object
                  custom_equipment:
                    type: object