Vehicle Verification

Description

Validation of Vehicles registration in Argentina.

HTTP method GET

Endpoint

https://api.msla-id.com/experience-background-vehicleverif-api-v1/api/idv-govcheck/v1/ar-identity/vehicles

[SANDBOX Environment]

For testing purposes, use the base domain: apidev.msla-id.com

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION
CUIL	✅	string	Argentina labor identification number

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error.
504	Gateway timeout — IDV-1100

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "34372f63ac42d547",
    "timestamp": "2024-10-17 12:04:00",
    "data": {
        "vehicles": {
            "data": [
                {
                    "dni": 12345678,
                    "plate": "ABC123",
                    "purchaseDate": "2023-10-13",
                    "model": "Corolla",
                    "percentage": 100,
                    "brand": "Toyota",
                    "origin": "Argentina",
                    "procedureDate": "2023-10-13",
                    "type": "Sedán",
                    "cuil": 20123456789,
                    "modelYear": 2020
                }
            ],
            "totalCount": 1
        },
        "vehicleHistory": {
            "data": [
                {
                    "dni": 87654321,
                    "plate": "XYZ789",
                    "purchaseDate": "2020-05-10",
                    "model": "Civic",
                    "percentage": 50,
                    "brand": "Honda",
                    "origin": "Brasil",
                    "procedureDate": "2023-01-15",
                    "type": "Familiar",
                    "cuil": 20987654321,
                    "modelYear": 2018
                }
            ],
            "totalCount": 1
        },
        "vehicleLiens": {
            "data": [
                {
                    "plate": "DEF456",
                    "debt": "25000",
                    "valuation": "350000",
                    "brand": "Ford",
                    "locality": "Rosario, Santa Fe"
                }
            ],
            "totalCount": 1
        }
    }
}

Response 404 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1002",
    "message": "Data not found."
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-3001",
    "message": "Bad request - Invalid or incomplete input data",
    "data": null
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1008",
    "message": "Error in the source of origin, please contact an administration."
}

Response 504 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1100",
    "message": "Gateway Timeout",
    "data": null
}