DocsICP FilingConsole
Documentation
Home Page ID Verification Information Verification Developer Reference Vehicle verification Query vehicle insurance dates

Query vehicle insurance dates

Updated at:
Copy as MD
Product
My Favorites

This topic describes the Vehicle Insurance Date Query API and its parameters.

API details

Important

Before calling this API, read the integration process and activate the service.

  • Operation name: VehicleInsureQuery

  • Description: Queries vehicle insurance information based on the license plate number, vehicle type, and vehicle identification number (VIN).

  • QPS limit: This API operation has a dedicated QPS limit. For more information, see QPS limits for ID-verification API operations.

  • Service address (endpoint for API calls):

    Region

    IPv4

    IPv6

    common

    cloudauth.aliyuncs.com

    cloudauth-dualstack.aliyuncs.com

    China (Beijing)

    cloudauth.cn-beijing.aliyuncs.com

    cloudauth-dualstack.cn-beijing.aliyuncs.com

    China (Shanghai)

    cloudauth.cn-shanghai.aliyuncs.com

    cloudauth-dualstack.cn-shanghai.aliyuncs.com

    Note

    • To reduce latency, select an endpoint that is geographically close to your servers.

    • You can also create a list of endpoints and poll them in rotation to improve availability.

    Important

    The Information Verification Service does not support a hard cap or automatic deactivation based on the number of calls. To control costs and prevent high bills, we recommend configuring spending alert rules:

    1. Configure spending alerts: Set High-Spending Alert thresholds to monitor your expenses in real time.

    2. Monitor your resource package balance: If you have purchased a resource package, also Set Resource Package Balance Alert. This lets you promptly replenish the package or adjust your call strategy.

    3. Configure business monitoring: See security management to monitor business requests for anomalies and fluctuations.

Request parameters

Parameter

Type

Required

Description

Example

ParamType

String

Yes

The encryption method. Valid values:

normal

VIN

String

Yes

The vehicle identification number (VIN). The format depends on the value of ParamType.

  • If ParamType is set to normal, pass the VIN in plaintext.

  • If ParamType is set to sm2, pass the encrypted VIN.

  • Plaintext: JHJ1234567890****

  • Ciphertext:

    MHkCIHAzOKePrMTWZ5ggXjYh9rkqK82nG/366i4JWKb7I1WpAiAuwgiJYyDSb9Iu1ADWczV4FTjE+zv8US4o+QbrnbV9jQQg9hXNt7qZHER3crKgdU0BHxzucwpZkuCMOMxMS5mMnDgEEYQy3UYzXbMELmFpJl4V0kfJ

VehicleType

String

No

Vehicle type:

  • 01: Large vehicle

  • 02: Standard passenger vehicle

  • 51: Large new energy vehicle

  • 52: New energy passenger vehicle

02

VehicleNum

String

No

The license plate number. The format depends on the value of ParamType.

  • If ParamType is set to normal, pass the license plate number in plaintext.

  • If ParamType is sm2, pass the encrypted license plate number.

  • Plaintext: ZJAF89**

  • Ciphertext:

    MHMCIQD01OTXYNshCTNbZubTt9rTJfoL6I9HMF0j5i0g8K8tUAIhAJWSnKmNKycoqM+Rg9T10CPwc+SllE4lpcJnAH+UyxSxBCCPgmj+0sgZzsqOR67/96IuIOTNjqB7092Q+fNHycb5pQQJKExoVUT4bGpL

Response

Parameter

Type

Description

Example

RequestId

String

The request ID.

130A2C10-B9EE-4D84-88E3-5384FF03****

Message

String

The response message.

success

Code

String

The response code. A value of 200 indicates success. Any other value indicates failure.

Important

  • This parameter indicates whether the API call was successful. For detailed descriptions of the return codes, refer to server-side error codes.

  • To see the business verification result, check the fields in ResultObject.

200

ResultObject

BizCode

String

The verification result. Valid values:

  • 1: Match found (billable)

  • 3: No record found (not billable)

1

VehicleInfo

String

A JSON string that contains the vehicle's insurance date information.

  • lastInsuranceDate: The year and month of the last insurance policy.

  • firstInsuranceDate: The date of the first insurance policy.

  • latestInsuranceDate: The end date of the most recent policy term.

  • latestInsuranceDateStart: The start date of the most recent policy term.

Important

Some fields may be absent due to data source limitations. Your code must gracefully handle missing fields.

{
    "firstInsuranceDate": "2018-08-10",
    "lastInsuranceDate": "2024-08",
    "latestInsuranceDate": "2025-08-10",
    "latestInsuranceDateStart": "2024-08-10"
}

SDK call example

Important

Before you integrate, read the integration process, activate the service, and get an AccessKey and configure the environment variables.

Get SDK samples and installation packages:

  • On the online API debugging page in OpenAPI, find the SDK sample code on the right. Click SDK installation information in the upper-right corner of the code sample to view installation details.

    Note

    Select the required programming language.

    image

  • For offline installation, go to the SDK installation page, select the SDK for your programming language, and download it from the publishing address.

    image

Previous：Vehicle information verificationNext：Credential forgery prevention