Data Inquiry

Description

As part of the Universal Submit API package, Data Inquiry allows you to view enriched company or location data including expanded contact information, company statistics, and additional location data for a potential prospect.

Authentication and Credentials

Obtain a Bearer Token

The Data Inquiry API uses the Insurance Intelligence Authenticate API to obtain a bearer token using your client_id, client_secret, and API key. The bearer token obtained from the Authentication API can be used to authenticate requests using the Data Inquiry API.

Your Bold Penguin project team will provide you with a unique client_id and client_secret for each environment as well as an API key and Data Package ID (dp_id).

Accessing the Data Inquiry API

Get Enriched Company/Location report data using reportId.

Prerequisite: The company or location submission is completed. As part of the response to the submission request, we will receive the reportId which can be used to obtain the data that is crawled for that entity.

Endpoint

Staging

https://api-smartdata.di-beta.boldpenguin.com/data/v4/{dp_id}/{report_id}

Production

https://api.ii.boldpenguin.com/data/v4/{dp_id}/{report_id}

Pass the below variables as part of the request

Request Parameters	Description
Authentication Token	The token obtained via the Authentication API
API Key	Provided by Bold Penguin
dp_id	Data Package ID provided by Bold Penguin
report_id	The company or the location reportId

Sample Company Data Inquiry Request

GET /data/v4/kowalski-us-c0001/CUS1187A2AAE214E4540
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: xxxxxxxxxxxxxxxxxxxxxx
Authorization: Bearer tVr79n7e19PWstA4KnF7vHE3

Sample Company Data Inquiry Response

{
    "tx_id": "dac4e0e7-a5b0-4cdd-bed7-a078a5234fe2",
    "tx_start_time": "2022-06-03T20:43:57.224Z",
    "tx_end_time": "2022-06-03T20:43:57.932Z",
    "response_time_secs": "0",
    "data_package_id": "kowalski-us-c0001",
    "tenant_id": "kowalski",
    "user_id": "0715308c-db1c-4e63-b854-779bc93bc77c",
    "c_report_id": "CUS1187A2AAE214E4540",
    "l_report_id": "LUS1187A2AAE214FBF35",
    "seed_input": {
        "company_name": "Bold Penguin Inc.",
        "address": "100 E Broad Street, Columbus, OH 43215"
    },
    "cleansed_input": {
        "entityType": "ORG",
        "companyName": "BOLD PENGUIN INC.",
        "website": "https://www.boldpenguin.com/",
        "phoneNumber": "6143441029",
        "confidence_score": 0.9500000000000001,
        "address": {
            "streetAddr": "100 E BROAD ST.",
            "city": "COLUMBUS",
            "state": "OH",
            "zipOrPostalCode": "43216",
            "country": "US",
            "countryISOCode": "",
            "geoPosition": {
                "latitude": 39.963070,
                "longitude": -82.997600
            }
        },
        "seedInput": {
            "companyName": "Bold Penguin Inc.",
            "address": {
                "streetAddr": "100 E Broad Street",
                "city": "Columbus",
                "state": "OH",
                "zipOrPostalCode": "43215",
                "country": "US"
            }
        }
    },
    "data": {
        "company_id": "CUS1187A2AAE214E4540",
        "company_name": "Bold Penguin Inc.",
        "dba_aka": [],
        "phone_number": "6143441029",
        "website": "https://www.boldpenguin.com/",
        "email_id": "hello@boldpenguin.com",
        "address": "100 E BROAD ST.",
        "city": "COLUMBUS",
        "state": "OH",
        "postal_code": "43215",
        "duns_number": "152814619",
        "primary_naics_2017": [
            {
                "code": "000000",
                "desc": "Example 2017 NAICS Description"
            }
        ],
        "secondary_naics_2017": [
            {
                "code": "000000",
                "desc": "Example Secondary 2017 NACIS Description"
            }
        ],
        "year_founded": "2016",
        "annual_revenue": "100.0",
        "annual_payroll": "100.00",
        "total_full_time_employees": "100",
        "total_employees_at_this_location": "100",
        "primary_naics_2012": [
            {
                "code": "000000",
                "desc": "Example 2012 NAICS Description"
            }
        ],
        "secondary_naics_2012": [
            {
                "code": "000000",
                "desc": "Example Secondary 2012 NACIS Description"
            }
        ],
        "parent_company_revenue": "100,000",
        "parent_company_revenue_currency_code": "USD"
    },
    "scores": {
        "company_id": "85.16",
        "company_name": "96.64",
        "website": "97.83",
        "address": "94.64",
        "city": "94.64",
        "state": "94.64",
        "postal_code": "94.64",
        "duns_number": "100.00",
        "primary_naics_2017": "82.42",
        "year_founded": "95.16",
        "annual_revenue": "68.35",
        "annual_payroll": "95.99",
        "total_full_time_employees": "80.64",
        "total_employees_at_this_location": "80.64",
        "primary_naics_2012": "82.42",
        "parent_company_revenue": "85.16",
        "parent_company_revenue_currency_code": "85.16"
    }
}

Sample Location Data Inquiry Request

GET /data/v4/kowalski-us-c0001/CUS1187A2AAE214E4540
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: xxxxxxxxxxxxxxxxxxxxxx
Authorization: Bearer t1i29n7q19PWstK4KnF7vHE3

Sample Location Data Inquiry Response

{
    "tx_id": "dac4e0e7-a5b0-4cdd-bed7-a078a5234fe2",
    "tx_start_time": "2022-06-03T20:43:57.224Z",
    "tx_end_time": "2022-06-03T20:43:57.932Z",
    "response_time_secs": "0",
    "data_package_id": "kowalski-us-c0001",
    "tenant_id": "kowalski",
    "user_id": "0715308c-db1c-4e63-b854-779bc93bc77c",
    "c_report_id": "CUS1187A2AAE214E4540",
    "l_report_id": "LUS1187A2AAE214FBF35",
    "seed_input": {
        "company_name": "Bold Penguin Inc.",
        "address": "100 E Broad Street, Columbus, OH 43215"
    },
    "cleansed_input": {
        "entityType": "ORG",
        "companyName": "BOLD PENGUIN INC.",
        "website": "https://www.boldpenguin.com/",
        "phoneNumber": "6143441029",
        "confidence_score": 0.9500000000000001,
        "address": {
            "streetAddr": "100 EAST BROAD STREET",
            "city": "COLUMBUS",
            "state": "OH",
            "zipOrPostalCode": "43215",
            "country": "US",
            "countryISOCode": "",
            "geoPosition": {
                "latitude": 39.963070,
                "longitude": -82.997600
            }
        },
        "seedInput": {
            "companyName": "Bold Penguin Inc.",
            "address": {
                "streetAddr": "100 E Broad St.",
                "city": "Columbus",
                "state": "OH",
                "zipOrPostalCode": "43215",
                "country": "US"
            }
        }
    },
    "data": {
        "company_id": "CUS1187A2AAE214E4540",
        "company_name": "BOLD PENGUIN INC.",
        "dba_aka": [],
        "phone_number": "6143441029",
        "website": "https://www.boldpenguin.com/",
        "email_id": "hello@boldpenguin.com",
        "address": "100 EAST BROAD STREET",
        "city": "COLUMBUS",
        "state": "OH",
        "postal_code": "43215",
        "duns_number": "152814619",
        "primary_naics_2017": [
            {
                "code": "000000",
                "desc": "Example 2017 NAICS Description"
            }
        ],
        "secondary_naics_2017": [
            {
                "code": "000000",
                "desc": "Example 2017 Secondary NAICS Description"
            }
        ],
        "year_founded": "2016",
        "annual_revenue": "100.0",
        "annual_payroll": "100.00",
        "total_full_time_employees": "100",
        "total_employees_at_this_location": "100",
        "primary_naics_2012": [
            {
                "code": "000000",
                "desc": "Example 2012 NAICS Description"
            }
        ],
        "secondary_naics_2012": [
            {
                "code": "000000",
                "desc": "Example 2012 Secondary NAICS Description"
            }
        ],
        "parent_company_revenue": "100,000",
        "parent_company_revenue_currency_code": "USD"
    },
    "scores": {
        "company_id": "85.16",
        "company_name": "96.64",
        "website": "97.83",
        "address": "94.64",
        "city": "94.64",
        "state": "94.64",
        "postal_code": "94.64",
        "duns_number": "100.00",
        "primary_naics_2017": "82.42",
        "year_founded": "95.16",
        "annual_revenue": "68.35",
        "annual_payroll": "95.99",
        "total_full_time_employees": "80.64",
        "total_employees_at_this_location": "80.64",
        "primary_naics_2012": "82.42",
        "parent_company_revenue": "85.16",
        "parent_company_revenue_currency_code": "85.16"
    }
}

Get Data Using Transaction ID

Prerequisite: The documents (eml, pdf, word-docs, excel) are submitted via the universal submit api. As part of the response to universal submit we will receive a transactionId which can be used to obtain the extracted & enriched data post document processing

Based on the data package ID (dp_id) being used to query data, the output of the api varies.

The output response could be company data, location data, a list of companies, or list of locations based on the document that is processed. Listed below are sample responses corresponding to the responses listed above. .

Endpoint

Staging

https://api-smartdata.di-beta.boldpenguin.com/data/v4/{dp_id}/{tx_id}

Production

https://api.ii.boldpenguin.com/data/v3/{dp_id}/{tx_id}?idType=transaction

Pass the below variables as part of the request

Request Parameters	Description
Authentication Token	TThe token obtained via the Authentication API
API Key	Provided by Bold Penguin
dp_id	Data Package ID provided by Bold Penguin
tx_id	This ID is returned as part of the Universal Submit response
idType	query parameter idType=transaction

Sample Company Data Inquiry Request

GET /data/v4/kowalski-us-c0006/9fb6b3fe-5e90-4610-a2ab-dbea6656dd0e 
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: xxxxxxxxxxxxxxxxxx
Authorization: Bearer 5ZhAzSrQCuyYct367GqfSnwE

Sample Company Data Inquiry Response

{
  "tx_id": "67611507-0687-4aec-aca1-0a9d3976a69c",
  "tx_start_time": "2022-03-08T18:53:57.242Z",
  "tx_end_time": "2022-03-08T18:54:11.075Z",
  "response_time_secs": "13",
  "data_package_id": "kowalski-us-c0006",
  "tenant_id": "kowalski",
  "user_id": "test",
  "c_report_id": "CUS1187A9346D1C83129",
  "l_report_id": "LUS1187A9346D1C8F76E",
  "doc_reference_id": "9fb6b3fe-5e90-4610-a2ab-dbea6656dd0e ",
  "seed_input": {
    "company_name": "Bold Penguin",
    "address": "100 E Broad Street Columbus OH 43215"
  },
  "cleansed_input": {
    "companyName": "BOLD PENGUIN INC",
    "website": "www.boldpenguin.com",
    "phoneNumber": "6143441029",
    "confidence_score": 0.9966666666666667,
    "address": {
      "streetAddr": "100 EAST BROAD ST",
      "city": "COLUMBUS",
      "state": "OH",
      "zipOrPostalCode": "43215",
      "country": "US",
      "countryISOCode": "",
      "geoPosition": {
        "latitude": 39.963070,
        "longitude": -82.997600
      }
    },
    "seedInput": {
      "companyName": "BOLD PENGUIN INC",
      "address": {
        "streetAddr": "100 East Broad St",
        "city": "Columbus",
        "state": "OH",
        "zipOrPostalCode": "43215",
        "country": "US"
      }
    },
    "dunsNumber": "152814619"
  },
  "data": {
    "facts": {
      "company_name": "BOLD PENGUIN INC.",
      "website": "www.boldpenguin.com",
      "address": "100 East Broad St",
      "city": "Columbus",
      "state": "OH",
      "postal_code": "43215",
      "duns_number": "152814619",
      "legal_entity_type": "Corporation",
      "year_founded": "2016",
      "annual_revenue": "100,000",
      "bankruptcy_indicator": "N",
      "smart_company_credit_grade": "A",
      "primary_naics_2012": [
        {
          "code": "000000",
          "desc": "Example 2012 NAICS Description"
        }
      ],
      "secondary_naics_2012": [
        {
          "code": "000000",
          "desc": "Example Secondary 2012 NAICS Description"
        }
      ],
      "company_number": "",
      "has_company_been_liquidated": "",
      "company_jurisdiction": "",
      "insolvency_history": "",
      "country": "US",
      "global_ultimate_duns": "",
      "company_description": [
        "Bold Penguin products help insurance people successfully quote and bind small business insurance policies with the click of a few buttons. "
      ],
      "vat_number": "",
      "ern_number": "",
      "subsidiary_companies": [],
      "does_company_has_office365_exposure": "Y",
      "does_any_employee_works_at_airports": "N",
      "does_any_employee_works_at_blast_furnaces": "N",
      "does_any_employee_works_at_boat_yard": "N",
      "does_any_employee_works_at_bridges": "N",
      "does_any_employee_works_at_chimney_shafts": "N",
      "does_any_employee_works_at_collieries": "N",
      "does_any_employee_works_at_computer_rooms": "N",
      "does_any_employee_works_at_docks": "N",
      "does_any_employee_works_at_fences_on_motorways": "N",
      "does_any_employee_do_gas_exploration_work": "N",
      "does_any_employee_works_at_hangars": "N",
      "does_any_employee_works_at_harbours": "N",
      "does_any_employee_works_at_marine_watercraft_hovercraft": "N",
      "does_any_employee_works_at_mines": "N",
      "does_any_employee_works_at_motor_vehicle_cycles": "N",
      "does_any_employee_works_at_nuclear_establishments": "N",
      "does_any_employee_works_at_offshore_structures": "N",
      "does_any_employee_works_at_oil_gas_chemical_bulk_storage": "N",
      "does_any_employee_works_at_oil_gas_chemical_production_premises": "N",
      "does_any_employee_works_at_petrochemical_works": "N",
      "does_any_employee_works_at_pharmaceuticals": "N",
      "does_any_employee_works_at_piers": "N",
      "does_any_employee_works_at_power_stations": "N",
      "does_any_employee_works_at_quarries": "N",
      "does_any_employee_works_at_railways": "N",
      "does_any_employee_works_at_refineries": "N",
      "does_any_employee_works_at_steel_structures": "N",
      "does_any_employee_works_at_steeples": "N",
      "does_any_employee_works_at_tanks": "N",
      "does_any_employee_works_at_towers": "N",
      "does_any_employee_works_at_underground": "N",
      "does_any_employee_works_at_underwater": "N",
      "is_non_profit_company": "",
      "has_business_in_operation_for_more_than_3yrs": "Y",
      "does_any_employee_undertakes_demolition_work": "N",
      "does_any_employee_undertakes_work_involving_roofing_scafolding_abseiling_cradles": "Y",
      "is_any_work_carried_out_other_than_collection_and_delivery": "N",
      "does_any_employee_works_at_dams": "N",
      "does_any_employee_works_with_heat_fire": "N",
      "parent_company_revenue": "",
      "registered_in_countries": [
        "US"
      ],
      "assets_in_countries": [],
      "product_sold_in_countries": [
        "US"
      ],
      "parent_company_revenue_currency_code": "USD",
      "total_legal_fillings": "",
      "dnb_rating": "68BI",
      "dnb_rating_description": "Moderate",
      "dnb_review_date": "2021-07-18",
      "parent_company_global_sales": "",
      "has_there_been_health_and_safety_breach": "N"
    },
    "options": {
      "programme_type": "",
      "product": [
        "Casualty",
        "Liability",
        "Combined Liability"
      ],
      "policy_inception_date": "2021-04-01",
      "field_office": "",
      "exclusive_flag": "N",
      "end_date": "",
      "document_date": "2021-03-12",
      "broker_contact_points": "",
      "coverage": [],
      "100_pct_limit": "",
      "broker_name": "",
      "underwriter": "",
      "broker_address": "",
      "broker_city": "",
      "broker_postal_code": "",
      "broker_state": "",
      "broker_email": "",
      "estimated_premium": "28,000",
      "risk_country": "",
      "business_interruption_period": "",
      "decline_reason": "",
      "form_submission_type": [
        "submission",
        "quote"
      ],
      "broker_contact_phone": "",
      "policy_inception_effective_time": "",
      "policy_end_time": ""
    }
  },
  "scores": {
    "company_name": "84.34",
    "website": "78.19",
    "address": "80.64",
    "city": "80.64",
    "state": "80.64",
    "postal_code": "80.64",
    "legal_entity_type": "84.34",
    "year_founded": "82.42",
    "annual_revenue": "75.59",
    "smart_company_credit_grade": "82.96",
    "primary_naics_2012": "84.34",
    "policy_inception_date": "90.00",
    "exclusive_flag": "80.00",
    "document_date": "90.00",
    "broker_contact_points": "90.00",
    "broker_email": "90.00",
    "estimated_premium": "90.00"
  }
}

Sample Location Data Inquiry Request

GET /data/v4/kowalski-us-l0006/7f782ee1-805c-41b7-9b8e-ea698d9a42c0
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: xxxxxxxxxxxxxxxxxxx
Authorization: Bearer 6TGW73tr93LFNmwNwqCFSxKW

Sample Company Data Inquiry Response

{
    "tx_id": "18e12983-95d2-4f5d-aa9c-8e4557470932",
    "tx_start_time": "2022-05-18T18:21:57.573Z",
    "tx_end_time": "2022-05-18T18:22:09.466Z",
    "response_time_secs": "11",
    "data_package_id": "kowalski-us-l0006",
    "tenant_id": "kowalski",
    "user_id": "eacb9e0f-7bf8-4068-bb29-e8a83f121776",
    "l_report_id": "",
    "doc_reference_id": "7f782ee1-805c-41b7-9b8e-ea698d9a42c0",
    "data": [
        {
            "facts": {
                "location_id": "LUS1187C433723834E72",
                "location_address": "100 E Broad St",
                "location_city": "Columbus",
                "location_state": "OH",
                "location_postal_code": "43215",
                "location_country": "US",
                "year_built": "",
                "latitude": "39.963070",
                "longitude": "-82.997600",
                "total_building_area_sqft": 10000,
                "total_floors": ""
            },
            "options": {
                "location_doc_id": "1000-USA-Orch",
                "location_name": "",
                "location_county": "",
                "building_value": "15,000,000",
                "personal_property_value": 10000000,
                "business_interruption_value": "",
                "stock_tiv": "0",
                "location_application_limit": "44,800,000"
            },
            "scores": {
                "location_doc_id": "50.00",
                "location_address": "76.96",
                "location_city": "76.96",
                "location_state": "76.96",
                "location_postal_code": "76.96",
                "location_country": "80.64",
                "building_value": "90.00",
                "personal_property_value": "90.00",
                "latitude": "78.19",
                "longitude": "78.19",
                "total_building_area_sqft": "80.64",
                "stock_tiv": "90.00",
                "location_application_limit": "90.00"
            }
        },
        ....
        ....
    ]
}

Sample Data Inquiry Request for Claims Bordereaux

GET /data/v4/kowalski-claims-c0001/1605b463-c6d7-4751-84d4-c62f3ae98203
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: xxxxxxxxxxxxxxxxx
Authorization: Bearer 6TGW73tr93LFNmwNwqCFSxKW

Sample Company Data Inquiry Response

{
    "tx_id": "16d0789c-2068-46ce-a51e-0ba188a1334a",
    "tx_start_time": "2022-05-18T19:06:03.236Z",
    "tx_end_time": "2022-05-18T19:06:03.560Z",
    "response_time_secs": "0",
    "data_package_id": "kowalski-claims-c0001",
    "tenant_id": "kowalski",
    "user_id": "eacb9e0f-7bf8-4068-bb29-e8a83f121776",
    "doc_reference_id": "1605b463-c6d7-4751-84d4-c62f3ae98203",
    "data": [
        {
            "options": {
                "policy_number": "Y3101961928",
                "insured_name": "Bold Penguin Inc.",
                "date_of_loss": "16/02/2020",
                "loss_number": "666142 (1)",
                "claim_amount_currency": "",
                "claim_already_paid_amount": 100.00,
                "claim_to_be_paid_amount": 210.00,
                "claim_reserve": 0,
                "claim_incurred": "",
                "loss_description": ""
            },
            "scores": {
                "insured_name": "85.16",
                "date_of_loss": "85.16",
                "loss_number": "85.16",
                "claim_already_paid_amount": "85.16",
                "claim_to_be_paid_amount": "85.16",
                "claim_reserve": "85.16",
                "loss_description": "85.16"
            }
        }
        ....
        ....
    ]
}

Description​

Authentication and Credentials​

Accessing the Data Inquiry API​

Endpoint​

Staging​

Production​

Sample Company Data Inquiry Request​

Sample Company Data Inquiry Response​

Sample Location Data Inquiry Request​

Sample Location Data Inquiry Response​

Get Data Using Transaction ID​

Endpoint​

Staging​

Production​

Sample Company Data Inquiry Request​

Sample Company Data Inquiry Response​

Sample Location Data Inquiry Request​

Sample Company Data Inquiry Response​

Sample Data Inquiry Request for Claims Bordereaux​

Sample Company Data Inquiry Response​

Description

Authentication and Credentials

Accessing the Data Inquiry API

Endpoint

Staging

Production

Sample Company Data Inquiry Request

Sample Company Data Inquiry Response

Sample Location Data Inquiry Request

Sample Location Data Inquiry Response

Get Data Using Transaction ID

Endpoint

Staging

Production

Sample Company Data Inquiry Request

Sample Company Data Inquiry Response

Sample Location Data Inquiry Request

Sample Company Data Inquiry Response

Sample Data Inquiry Request for Claims Bordereaux

Sample Company Data Inquiry Response