Auto API

Description

A solution that provides general information on the Mexican vehicle fleet using the license plate of each car to be verified.

HTTP method POST

Endpoint

https://8ehec73psb.execute-api.us-west-2.amazonaws.com/uat/identity/api/idv-govcheck/v1/mx-identity/{curp}/check-vehicle-identity

info

Before proceeding, make sure you have your jwt token, if you don't, check the login documentation.

Request header parameter

NAME	REQUIRED	TYPE	DESCRIPTION
Authorization	✅	string	bearer jwt token

URI request parameter

NAME	REQUIRED	TYPE	DESCRIPTION	EXAMPLE
plate	✅	string	Metal plates installed on the front and rear of the vehicle, with an alphanumeric code that serves as identification.	-

Status code responses

Code	Description
200	OK
400	Bad request
401	Unauthorized
404	Not found
500	Internal server error.

The full documentation error codes can be found here.

Response 200 status code

{
    "traceId": "b2345cfc7bee621e",
    "timestamp": "2023-05-15 11:59:35",
    "data": {
        "Id": "string",
        "NIV": "string",
        "Brand": "string",
        "Class": "string",
        "Model": "string",
        "Sub-brand": "string",
        "Version": "string",
        "Type": "string",
        "Displacement": "string",
        "Numberofcylinders": "string",
        "Countryoforigin": "string",
        "Numberofdoors": "string",
        "Assemblyplant": "string",
        "Complementaryinfo": "string",
        "Inscriptionname": "string",
        "Registrationdate": "string",
        "Registrationhour": "string",
        "Platedate": "string",
        "Lastupdate": "string",
        "Statecode": "string",
        "Entity": "string"
    }
}

Response 400 status code

{
    "traceId": "542fc743fffda052",
    "timestamp": "2023-05-05 11:20:46",
    "code": "IDV-4005",
    "message": "-",
    "data": null
}

Response 401 status code

{
    "timestamp": "YYYY-MM-DDTHH:mm:ss.sssZ",
    "status": 401,
    "error": "Unauthorized",
    "path": "/api/idv-govcheck/v1/mx-identity/{curp}/check-vehicle-identity"
}

Response 500 status code

{
    "traceId": "43a20f33d4e8730d",
    "timestamp": "yyyy-mm-dd HH:MM:SS",
    "code": "IDV-1001",
    "message": "A generic error has occurred.",
    "data": null
}