Skip to main content

Market Intelligence

The Market Intelligence API is a service that can return carrier intelligence data related to a given risk. The service will help to determine carrier tiering, ranking, and/or exclusion at time of eligibility determination based on a set of rules established by the partner.

Authentication​

Follow the instructions for OAuth2 authentication as described here.

Endpoint​

Staging​

https://carrier-engine-uat.alpha.boldpenguin.com/market_recommendation

Production​

https://carrier-engine.boldpenguin.com/market_recommendation

Methods​

GET

Request Parameters​

Query Parameters​

  • state
    • The state code or full state name
    • Type: String
    • Required: Yes
  • naics
    • The business type being insured
    • String
    • Required: Yes
    • NOTE: NAICS descriptions are currently derived from the 2012 NAICS and must match exactly
  • product
    • The coverage type to search for. The product param can be passed in multiple times to query for additional products
    • Type: String
    • Required: Yes
    • Examples:
      • BOP
      • WC
      • Workers Compensation
      • Umbrella
      • bond
      • GL
      • PL
      • OTHER
  • carrier
    • The carrier to search for. This field can be a partial match. The carrier param can be passed in multiple times to query for additional carriers
    • Type: String
    • Required: No

Response Elements​

  • state_cd
    • The state code
  • carrier_id
    • The uuid of the carrier
  • carrier_nm
    • The name of the carrier
  • naics_desc
    • The business type
  • product_desc
    • The coverage type
  • avg_carrier_questions
    • The average number of questions on a carrier's question set
  • avg_premium
    • The average premium amount over a certain time period
  • avg_response_times
    • The average API quote request response time in seconds
  • bindable_rate
    • Percent of successful quote requests that have ready_to_bind in response_meta
  • bp_market_score
    • Bold Penguin proprietary multi-factor value
  • percentile
    • Lower and upper bound of the Median Premium range
  • quote_rate
    • The percentage of successful quotes out of all quote requests over a certain time period
  • submissions
    • The total number of submissions over a certain time period

Examples​

Sample Request​

curl -L -g 
  'https://carrier-engine-uat.alpha.boldpenguin.com/market_recommendation?state=Oregon&naics=Janitorial%20services&product[]=GL&product[]=BOP&carrier[]=hiscox&carrier[]=cna' 
  --header 'Authorization: bearer bps_thisismytokentherearemanylikeitbutthisoneismine'

Sample Response​

[
    {
        "state_cd": "OR",
        "carrier_id": "a6e4388b-0305-4d88-ba46-48cb44ea643f",
        "carrier_nm": "Hiscox",
        "naics_desc": "Janitorial services",
        "product_desc": "General Liability",
        "bindable_rate": "0.469627742",
        "percentile_25": "522.99",
        "percentile_75": "1973.82",
        "median_premium": "634.77",
        "bp_market_score": "3150.28",
        "quote_rate_7days": "0.8",
        "avg_response_times": "13.3",
        "quote_rate_180days": "0.786331",
        "avg_premium_180days": "1285.32",
        "submissions_180days": "79",
        "avg_carrier_questions": "2.466666667"
    }
]