BINS API


Description

Building Identification Numbering System
  • The BINS Address Search receives an address as input and returns the campus, site, building and unit information for that address. Data elements returned include BINS ID, address, land use and occupancy information.
  • The BINS ID Lookup receives a BINS ID and returns the address and campus, site, building and unit information associated with the BINS ID.

Technical Details

  • REST URL’s
    • User Acceptance Environment (UAT)
      • https://gatewayuat.verisk.com/underwriting/buildingstructure/geocode/bins/v1
    • Production (PROD)
      • https://gateway.verisk.com/underwriting/buildingstructure/geocode/bins/v1

  • HTTP Method
    • POST

  • 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

  • Required Parameters for BINS Address Search
    • OrgId :- Request.Header.Authorization.OrgId
    • ShipId :- Request.Header.Authorization.ShipId
    • SearchType :- S(strict only)
    • Street1 :- Request.Body.Address.Street1
    • City :- Request.Body.Address.City
    • StateCode :- Request.Body.Address.StateCode

  • Required Parameters for BINS ID Lookup
    • OrgId :- Request.Header.Authorization.OrgId
    • ShipId :- Request.Header.Authorization.ShipId
    • SearchType :- S(strict only)
    • BINSId:- Request.BINSId

  • 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


You can specify that you would like to receive your response as XML simply by setting a Header of "Accept" to "application/xml"

  • 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 PLUWClientServices@verisk.com or your Account Manager for Request/Response Samples and Schemas