ISO Risk Analyzer® Homeowners Environmental API GetScore


Description

The ISO Risk Analyzer Environmental API provides an effective way to access Risk Analyzer Homeowners Environmental module components and loss costs. The GetScore method returns Homeowners data at the Census Block Group, ZIP Code, or Census Block Group/ISO Territory levels.

Technical Details

  • REST URL’s
    • User Acceptance Environment (UAT)
      • https://gatewayuat.verisk.com/rating/riskanalyzerenvironmental/score/v1
    • Production (PROD)
      • https://gateway.verisk.com/rating/riskanalyzerenvironmental/score/v1

  • 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

  • Form Data
    • Required Parameters
      • OrgId: Request.Header.Authorization.OrgId
      • ShipId: Request.Header.Authorization.ShipId
      • product: Request.Body.product
        (Allowed values: “raho”)
      • ppc: Request.Body.ppc
      • If geoLevel parameter is blank or “cbg”
        • One of the parameters below is required:
          • address: Request.Body.address
            • Use commas to parse address segments: number & street, city, state, zip
          • fips: Request.Body.fips
          • latitude/longitude pair:
            latitude: Request.Body.latitude
            longitude: Request.Body.longitude
      • If geoLevel parameter is "terr”, “zip”, “mcd” or “mcd-terr”
        • The parameter below is required:
          • address: Request.Body.address
            • Use commas to parse address segments: number & street, city, state, zip
    • Optional Parameters
      • QuoteBack: Request.Header.QuoteBack
      • Version: Request.Body.version
        (if parameter not used, results for most recent table version returned)
        • format: yyyymmdd
      • Excl: Request.Body.excl
        (only model loss costs included in response; component details are excluded)
        • format: Y
      • geoLevel: Request.Body.geoLevel
        (if parameter not used, results for CBG geo level will be returned. Allowed values: “cbg”, “terr”, “zip”, “mcd” or “mcd-terr”)
      • isoTerritory: Request.Body.isoTerritory
        (if parameter not used, isoTerritory code derived from provided address will be used as input)


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

Samples and Schemas

  • Please contact EnvAPIHelp@verisk.com or Product Manager for Request/Response Samples and Schemas.