Lien Check API Documentation

Vehicle Lien Check API

View Sample Get Started

The Lien Check API offers access to vehicle lien records for all Canadian provinces & territories. This API enables users to conduct searches based on vehicle identification numbers (VINs) and obtain comprehensive data regarding any existing liens, security interests, or encumbrances registered against a specific vehicle. Through seamless integration into various systems in each jurisdiction, this API empowers businesses and individuals to efficiently access current lien information.

Lien Check API is specifically designed to work for Canadian provinces: Alberta, British Columbia, Manitoba, Ontario, Quebec, Saskatchewan, New Brunswick, Nova Scotia, Newfoundland and Labrador, Prince Edward Island, Northwest Territories, Yukon, Nunavut.

– Input: a vehicle’s 17-character VIN code.
– Output: Generated Lien Report

Vehicle Lien Check API

Documentation

To retrieve Lien Check report request:

https://liens.vinaudit.com/v1/canada-liens?user=<user>&key=<key>&jurisdiction=<province>&vin=<vin>&format=<format>

Request Parameters:

Name	Description	Required	Example
user	The VinAudit user account	Yes	user12345
key	Your VinAudit API key	Yes	VA_DEMO_KEY
vin	The vehicle identification number	Yes	5NPEU46F56H115055
jurisdiction	The 2 letter abbreviation for the province or territory to query	Yes	AB
format	The output format: json or xml	No	json

Lien Response Elements for each Lien Record

Table format

id: <report id>,
date:<date report was ran>,
vin:<vin searched in input>,
status: <generating/generated/failed>,
liens:

Elements	Description
number	The lien registration number
registration_type	The type of lien registered
registration_date	The date the lien was registered
expiration_date	The date on which the lien will expire
discharged_date	The date the lien was discharged (BC only)
duration	The total duration of the lien in years
status	The current status of the lien
registration_description	Details of the financial instrument
debtor_parties	id: The ID of the debtor party name: The name of the debtor. entity_type: The party type of entity. address: The address of the debtor. city: The city of the debtor. postal_code: The postal code of the debtor. province: The Province of the debtor. birth_date: The birth date of the debtor in UTC timezone.
registering_parties	id: The ID of the registering party. name: The name of the registering party. entity_type: The entity type of the registering party. address: The street address of the registering party. city: The city of the registering party. postal_code: The postal code of the registering party province: The Province of the registering party.
secured_parties	id: The ID of the secured party. name: The name of the secured party. entity_type: The entity type of the secured party. address: The address of the secured party. city: The city of the secured party. postal_code: The postal code of the secured party. province: The Province of the secured party.
collateral_vehicle	type: Motor vehicle type. year: Year of the vehicle. make: Make of the vehicle. model: Model of the vehicle. serial_number: VIN number of the vehicle. color: The color of the vehicle. collateral_amount: CAD amount for collateral vehicle.

success: Indicates whether the API call was successful or not with one of: true: report was successfully generated OR false: An error occurred while generating report.

error: One of: invalid_vin: Not a valid 17-digit VIN OR unauthorized_request: Invalid API Key/Username/Password OR blank if no error.

Flat file format


id | The ID of the lien report
date | The date the lien report was generated
vin | The VIN queried for the lien report
status | The status of the lien report generation (generating/ generated/ failed)
liens | A list of active lien records (if any) associated with VIN
liens[i].number | The lien registration number
liens[i].registration_type | The type of lien registered
liens[i].registration_date | The date the lien was registered
liens[i].discharged_date | The date the lien was discharged
liens[i].expiration_date | The date on which the lien will expire
liens[i].duration | The total duration of the lien in years
liens[i].status | The current status of the lien
liens[i].registration_description | Details of the financial instrument
liens[i].debtor_parties.id | The ID of the debtor party
liens[i].debtor_parties.name | The name of the debtor
liens[i].debtor_parties.entity_type | The party type of entity
liens[i].debtor_parties.address | The address of the debtor
liens[i].debtor_parties.city | The city of the debtor
liens[i].debtor_parties.postal_code | The postal code of the debtor
liens[i].debtor_parties.province | The Province of the debtor
liens[i].debtor_parties.birth_date | The birth date of the debtor in UTC timezone
liens[i].registering_parties.id | The ID of the registering party
liens[i].registering_parties.name | The name of the registering party
liens[i].registering_parties.entity_type | The entity type of the registering party
liens[i].registering_parties.address | The street address of the registering party
liens[i].registering_parties.city | The city of the registering party
liens[i].registering_parties.postal_code | The postal code of the registering party
liens[i].registering_parties.province | The Province of the registering party
liens[i].secured_parties.id | The ID of the secured party
liens[i].secured_parties.name | The name of the secured party
liens[i].secured_parties.entity_type | The entity type of the secured party
liens[i].secured_parties.address | The address of the secured party
liens[i].secured_parties.city | The city of the secured party
liens[i].secured_parties.postal_code | The postal code of the secured party
liens[i].secured_parties.province | The Province of the secured party
liens[i].collateral_vehicle.type | Motor vehicle type
liens[i].collateral_vehicle.year | Year of the vehicle
liens[i].collateral_vehicle.make | Make of the vehicle
liens[i].collateral_vehicle.model | Model of the vehicle
liens[i].collateral_vehicle.serial_number | VIN number of the vehicle
liens[i].collateral_vehicle.color |  Color of the vehicle
liens[i].collateral_vehicle.collateral_amount | CAD amount for collateral vehicle

success: Indicates whether the API call was successful or not with one of: true: report was successfully generated OR false: An error occurred while generating report.

error: One of: invalid_vin: Not a valid 17-digit VIN OR unauthorized_request: Invalid API Key/Username/Password OR blank if no error.

Example request

Request:

https://liens.vinaudit.com/v1/canada-liens?key=VA_DEMO_KEY&jurisdiction=ON&vin=1HGCM82633A123456&format=json

Response:



{
    "id": 12345,
    "date": "2024-01-01 15:00",
    "vin": "1HGCM82633A123456",
    "liens": [
        [
            {
                "registration_type": "PPSA Financing Statement"
            },
            {
                "date_registration": "2023-06-29 15:00"
            },
            {
                "duration": "5 years"
            },
            {
                "status": "Active"
            },
            {
                "expiration_date": "2028-06-29"
            },
            {
                "discharged_date": ""
            },
            {
                "number": "5489327"
            },
            {
                "registration_description": "Personal property security registration"
            },
            {
                "debtor_parties": [
                    {
                        "id": "A1B2C3D4",
                        "address": "123 Maple Street, Suite 12",
                        "birth_date": "1985-09-12",
                        "city": "Vancouver",
                        "entity_type": "Individual",
                        "name": "Smith, John",
                        "postal_code": "V5K0A1",
                        "province": "BC"
                    },
                    {
                        "id": "E5F6G7H8",
                        "address": "123 Maple Street, Suite 12",
                        "birth_date": "1987-04-25",
                        "city": "Vancouver",
                        "entity_type": "Individual",
                        "name": "Doe, Jane",
                        "postal_code": "V5K0A1",
                        "province": "BC"
                    },
                    {
                        "id": "I9J0K1L2",
                        "address": "123 Maple Street, Suite 12",
                        "birth_date": "1983-02-17",
                        "city": "Vancouver",
                        "entity_type": "Individual",
                        "name": "Johnson, Emily",
                        "postal_code": "V5K0A1",
                        "province": "BC"
                    }
                ]
            },
            {
                "registering_parties": [
                    {
                        "id": "78965432",
                        "address": "456 Pine Road",
                        "city": "Edmonton",
                        "description": "Creditor",
                        "entity_type": "Organization",
                        "name": "ABC Credit Union",
                        "postal_code": "T5J2G1",
                        "province": "AB"
                    }
                ]
            },
            {
                "secured_parties": [
                    {
                        "id": "M3N4O5P6",
                        "address": "789 Oak Avenue, Suite 200",
                        "city": "Calgary",
                        "entity_type": "Enterprise",
                        "name": "XYZ Financial Group",
                        "postal_code": "T2P3H7",
                        "province": "AB"
                    }
                ]
            },
            {
                "collateral_vehicle": [
                    {
                        "collateral_amount": "15000",
                        "color": "Black",
                        "make": "BMW",
                        "model": "3 Series",
                        "serial_number": "WBABW334X1LJ12345",
                        "type": "Motor Vehicle",
                        "year": "2016"
                    }
                ]
            }
        ],
        [
            {
                "registration_type": "Garage Keepers Claim of Lien"
            },
            {
                "date_registration": "2023-08-17 09:14"
            },
            {
                "duration": "1 year"
            },
            {
                "status": "Active"
            },
            {
                "expiration_date": "2024-08-17"
            },
            {
                "number": "4527689"
            },
            {
                "registration_description": "Claim for unpaid garage services"
            },
            {
                "debtor_parties": [
                    {
                        "id": "Q7R8S9T0",
                        "address": "78 Elm Street",
                        "birth_date": "1990-03-22",
                        "city": "Toronto",
                        "entity_type": "Individual",
                        "name": "Brown, Lisa",
                        "postal_code": "M4B1B3",
                        "province": "ON"
                    }
                ]
            },
            {
                "registering_parties": [
                    {
                        "id": "U1V2W3X4",
                        "address": "321 Cedar Lane",
                        "city": "Winnipeg",
                        "description": "Garage Owner",
                        "entity_type": "Individual",
                        "name": "Jake's Auto Service",
                        "postal_code": "R3B2L8",
                        "province": "MB"
                    }
                ]
            },
            {
                "secured_parties": [
                    {
                        "id": "Y5Z6A7B8",
                        "address": "900 Birch Road",
                        "city": "Halifax",
                        "entity_type": "Enterprise",
                        "name": "Nova Scotia Lending",
                        "postal_code": "B3J2K9",
                        "province": "NS"
                    }
                ]
            },
            {
                "collateral_vehicle": [
                    {
                        "collateral_amount": "8000",
                        "color": "Red",
                        "make": "Audi",
                        "model": "A3",
                        "serial_number": "WAUB8GFF6H1015708",
                        "type": "Motor Vehicle",
                        "year": "2017"
                    }
                ]
            }
        ]
    ],
    "success": "true",
    "error": ""
}

The most comprehensive Automotive Data & Analytics

Automotive Market Trends & Insights
White Papers & Researches
Auto Market Analytics Articles