Skip to content

Car5Meta V2 (VIN) Query ​

Use Cases ​

  • Finance vehicle profiling: supplement model, engine, and first registration date via VIN or license plate to simplify data entry for auto pledge loans and owner loans.
  • Auto loan and financial lease risk control: verify the base data of pledged vehicles to assist credit and asset management.
  • Insurance and after-sales service: provide model basis for quoting, underwriting, repair, and parts matching.
  • Used car transaction verification: quickly complete vehicle data during acquisition, replacement, and delivery.

Endpoint ​

POST /api/v1/car5MetaByVinV2

See the cooperation email notification for the endpoint.

Request headers: Authorization: Bearer <ACCESS_TOKEN>, Content-Type: application/json.

Request Parameters ​

json
{"vin":"1HGBH41JXMN000001"}

vin is required. The service trims surrounding whitespace, converts to uppercase, and must conform to the 17-character VIN format; only this field is allowed in the request body.

bash
curl -X POST \
  "https://<API_HOST>/api/v1/car5MetaByVinV2" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"vin":"1HGBH41JXMN000001"}'

Response Fields ​

Common Response Fields ​

FieldTypeMeaning
codestringBusiness status code; 0000 success, 0001 no data, 4001 parameter error, 5001 service failure, 5002 supplier token failure.
messagestringBusiness processing result description.
dataobject/nullCar5Meta or Car7Meta vehicle profile; null on no-data or failure.
request_idstringRequest trace ID.

data Fields ​

FieldCar5MetaCar7MetaMeaning
vinYesYesVehicle identification number (VIN).
engineNumYesYesEngine number; may be null when no data.
engineModelYesYesEngine model; may be null when no data.
vehicleModelYesYesVehicle model; may be null when no data.
brandYesYesVehicle brand; may be null when no data.
firstRegistrationDateYesYesFirst registration date; format subject to the actual value, may be null.
carUsageNoYesVehicle usage type; e.g., "非营运" (non-operational), "非营业个人" (non-business individual); passed through from the supplier, non-closed enum, may be null.

V1 and V2 share the same response field structure; Car5Meta returns the first six fields, and Car7Meta additionally returns carUsage.

Examples ​

Success Response ​

json
{"code":"0000","message":"成功","data":{"vin":"1HGBH41JXMN00****","engineNum":"EN123456","engineModel":"EA211","vehicleModel":"SVW71512","brand":"大众","firstRegistrationDate":"2020-01-01"},"request_id":"request-id"}

Car5Meta returns VIN, engine number, engine model, vehicle model, brand, and first registration date. Fields other than VIN may be null.