BINS API

Modified on 2021/05/21 15:26 by Administrator — Categorized as: Personal Lines!United States

Table of Contents [Hide/Show]

Description
Technical Details
Samples and Schemas

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