ISO Risk Analyzer® Commercial Auto Vehicle Symbols Search


Description

By using this API, it will return vehicle make, model year, and associated rating relativities, which is filtered by VIN number and/or effective date.



Technical Details

  • REST URL’s
    • User Acceptance Environment (UAT)
      • https://gatewayuat.verisk.com/rating/riskanalyzercommercialauto/search/v2
    • Production (PROD)
      • https://gateway.verisk.com/rating/riskanalyzercommercialauto/search/v2

  • HTTP Method
    • Post

  • Headers (JSON)
    • Content-Type: application/json
    • Accept: application/json
    • Authorization: Bearer <access token retrieved from Security Token Service>
      • Token received from Security Service should be used as Bearer

  • Headers (XML)
    • Content-Type: application/xml
    • Accept: application/xml
    • Authorization: Bearer <access token retrieved from Security Token Service>
      • Token received from Security Service should be used as Bearer


  • Form Data
    • Required Parameters
      • OrgId: Request.Header.Authorization.OrderId
      • ShipId: Request.Header.Authorization.ShipId
      • VIN: Request.Body.VIN
    • Optional Parameters
      • QuoteBack: Request.Header.QuoteBack
      • EffectiveDate: Request.Body.EffectiveDate

To submit a date parameter in the query, you may include the EffectiveDate in the request. If no date is specified in the request, the most recent version will be returned by default.

Liability fields will only be visible in the response if your subscription includes Liability Symbols, and similarly, Collision and Comprehensive fields will only be visible if your subscription includes Physical Damage Symbols.

If a searched VIN is not in the database, the API will run an additional lookup based on the same Make/Trim and a prior Model year. The API will return Symbols and associated rating relativities if there is a match. To determine if a successful API response has utilized the prior model year lookup to return a match, a comparison can be made between the 10th position of the originally searched VIN to the 10th position of the VinSignificantPatternMask returned by the API; if the characters do not match, the API has invoked this secondary lookup to return the Symbols.

  • Headers
    • Regardless of which URL you are using, the following headers are required
      • Content-Type: application/json or application/xml
      • Accept: application/json or application/xml
      • Authorization: Bearer db6e8bdf3b8ce796d38f2cd4298d252

Samples and Schemas

  • Please contact VehAPIHELP@verisk.com or your Account Executive for Request/Response Samples and Schemas.