Australian Vehicles

    Query vehicle details, damage and stolen information for vehicles in or imported from Australia.

    Notes and Prerequisites

    • All the requests use GET parameters
    • We support XML format (default) and JSON formats.

    API URL

    Production: https://www.carjam.co.nz/api/car-au/

    Test: https://test.carjam.co.nz/api/car-au/

    Input

    • key — your API Key
    • f — response format (xml or json; if the parameter is not used, xml is returned)
    • vehicle identifier:
      • vin — vehicle VIN, or
      • chassis — vehicle chassis for vehicles before 1989, or
      • plate and state — for vehicles still in Australia use plate and one of the states/territories: ACT, NSW, NT, QLD, SA, TAS, VIC, WA
    • query_type see below

    plate must be used with state as it is unique within a state/territory, but not within the whole Australia.

    Query Types

    • VIND - VIN decoder (accepts only VIN as the vehicle identifier)
    • VINDL - VIN decoder lite (accepts only VIN as the vehicle identifier)
    • LU - Vehicle lookup
    • VD - Vehicle details
    • RS - Registration status
    • BC - Build and compliance
    • SC - Stolen check
    • WO - Damage/write-off check
    • VDBC - Vehicle details, build and compliance
    • RSBC - Registration status, build and compliance
    • VDRSBC - Vehicle details, registration status, build and compliance

    All the query types except VIND and VINDL work with any of the vehicle identifiers. E.g.

    ?key=<your_key>&query_type=VDBC&plate=TEST00&state=VIC

    ?key=<your_key>&query_type=VDBC&vin=KMHH351EMKU00TEST

    should return the same result. VIND and VINDL accept only vin.

    Outputs

    VIND

    <message>
      <vehicles>
        <make>Audi</make>
        <model>A1</model>
        <variant/>
        <series>8X</series>
        <build_year>2016</build_year>
        <model_year>2016</model_year>
        <body_style>Hatchback</body_style>
        <doors>5</doors>
        <seats>5</seats>
        <drive>FWD</drive>
        <fuel>
          <type>Petrol</type>
        </fuel>
        <engine>
          <cylinders>3</cylinders>
          <size_litres>1</size_litres>
        </engine>
        <transmission>
          <type>Sequential</type>
        </transmission>
      </vehicles>
    </message>

    VINDL

    <message>
      <vehicles>
        <make>Audi</make>
        <model>A1</model>
        <series>8X</series>
        <body_style>Hatchback</body_style>
        <fuel>
          <type>Petrol</type>
        </fuel>
        <engine>
          <cylinders>3</cylinders>
          <size_litres>1</size_litres>
        </engine>
        <transmission>
          <type>Sequential</type>
        </transmission>
      </vehicles>
    </message>

    LU

    <message>
      <vehicles __array="true">
        <vin/>
        <chassis>YR21000TEST</chassis>
        <registration>
          <plate>TEST20</plate>
          <state>VIC</state>
        </registration>
      </vehicles>
    </message>

    VD

    <message>
      <vehicles __array="true">
        <vin>KMHH351EMKU00TEST</vin>
        <chassis/>
        <registration>
          <plate>TEST00</plate>
          <state>VIC</state>
        </registration>
        <make>HYUNDAI</make>
        <model>I30</model>
        <colour>SILVER OR CHROME</colour>
        <body_type>CAR/SEDAN</body_type>
        <vehicle_type>CAR / SMALL PASSENGER VEHICLE</vehicle_type>
        <engine_number>G40000000000</engine_number>
      </vehicles>
    </message>

    RS

    <message>
      <vehicles __array="true">
        <vin>KMHH351EMKU00TEST</vin>
        <chassis/>
        <registration>
          <plate>TEST00</plate>
          <state>VIC</state>
          <status>REGISTERED</status>
          <expiry_date>2023-01-16</expiry_date>
        </registration>
      </vehicles>
    </message>

    BC

    <message>
      <vehicles __array="true">
        <vin>KMHH351EMKU00TEST</vin>
        <chassis/>
        <registration>
          <plate>TEST00</plate>
          <state>VIC</state>
        </registration>
        <compliance_plate>2019-07</compliance_plate>
        <year_of_manufacture>2019</year_of_manufacture>
      </vehicles>
    </message>

    SC

    <message>
      <vehicles __array="true">
        <vin>WAUZZZ8X4GB00TEST</vin>
        <chassis/>
        <registration>
          <plate>TEST80</plate>
          <state>VIC</state>
        </registration>
        <stolen __array="true">
          <type>Plate</type>
          <jurisdiction>VIC</jurisdiction>
          <reported_date>2021-02-21</reported_date>
          <summary>POL JUR-N REF-00789042100033645052</summary>
        </stolen>
      </vehicles>
    </message>

    WO

    <message>
      <vehicles __array="true">
        <vin>WAUZZZ8X4GB00TEST</vin>
        <chassis/>
        <registration>
          <plate>TEST80</plate>
          <state>VIC</state>
        </registration>
        <written_off __array="true">
          <damage_codes>F14N</damage_codes>
          <incident_code>Statutory Write-off</incident_code>
          <incident_recorded_date>2021-03-02</incident_recorded_date>
          <jurisdiction>VIC</jurisdiction>
          <type_code>Storm, Flood, Other Write-off</type_code>
        </written_off>
      </vehicles>
    </message>

    VDBC

    <message>
      <vehicles __array="true">
        <vin>WAUZZZ8X4GB00TEST</vin>
        <chassis/>
        <registration>
          <plate>TEST80</plate>
          <state>VIC</state>
        </registration>
        <make>AUD</make>
        <model>A1</model>
        <colour>BLUE</colour>
        <body_type>SEDAN</body_type>
        <vehicle_type>CAR / SMALL PASSENGER VEHICLE</vehicle_type>
        <engine_number>CHZ000000</engine_number>
        <compliance_plate>2016-07</compliance_plate>
        <year_of_manufacture>2016</year_of_manufacture>
      </vehicles>
    </message>

    RSBC

    <message>
      <vehicles __array="true">
        <vin>KMHH351EMKU00TEST</vin>
        <chassis/>
        <registration>
          <plate>TEST00</plate>
          <state>VIC</state>
          <status>REGISTERED</status>
          <expiry_date>2023-01-16</expiry_date>
        </registration>
        <compliance_plate>2019-07</compliance_plate>
        <year_of_manufacture>2019</year_of_manufacture>
      </vehicles>
    </message>

    VDRSBC

    <message>
      <vehicles __array="true">
        <vin>KMHH351EMKU00TEST</vin>
        <chassis/>
        <registration>
          <plate>TEST00</plate>
          <state>VIC</state>
          <status>REGISTERED</status>
          <expiry_date>2023-01-16</expiry_date>
        </registration>
        <make>HYUNDAI</make>
        <model>I30</model>
        <colour>SILVER OR CHROME</colour>
        <body_type>CAR/SEDAN</body_type>
        <vehicle_type>CAR / SMALL PASSENGER VEHICLE</vehicle_type>
        <engine_number>G40000000000</engine_number>
        <compliance_plate>2019-07</compliance_plate>
        <year_of_manufacture>2019</year_of_manufacture>
      </vehicles>
    </message>

    Test Vehicles

    Plate State VIN Chassis Registered Stolen Written-off
    TEST00 VIC KMHH351EMKU00TEST - YES NO NO
    TEST01 VIC MMAJJKL10HH00TEST - YES NO NO
    TEST20 VIC - YR21000TEST NO NO NO
    TEST21 VIC WDB1240312B00TEST - NO NO NO
    TEST80 VIC WAUZZZ8X4GB00TEST - NO YES YES