Skip to main content

Data Inquiry

Description

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

Authentication and Credentials

Step 1: Obtain a Bearer Token

The Data Inquiry API uses the Authenticate API to obtain a bearer token using your client_id and client_secret. This bearer token can be used to authenticate requests using the Data Inquiry API.

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 get the reportId which can be used to get the data that is crawled for that entity.

Endpoint

Staging

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

Production

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

Pass the below variables as part of the request

Request ParametersComments
Authentication TokenThe token obtained in STEP 1
API Key(Shared with the Customer)
dp_id(Data Package ID Shared with the Customer)
report_idThe company or the location reportId

Sample Company Data Inquiry Request

GET /data/v3/kowalski-us-c0001/CUS1187A2AAE214E4540
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: M4jHKvQ6dD4Y1sDiv7gEe6LIuqArhDin8XldfxoK
Authorization: Bearer NMav128jTZbbEK48o64UM94K

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": "jkasd789-45ty-xa34-12dc-a4a240bk141",
"c_report_id": "CUSDD97T2FAE114E52240",
"l_report_id": "LUS1387Y3Y8256746FC9",
"seed_input": {
"company_name": "Bold Penguin Inc.",
"address": "100 East Broad St, 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 ST",
"city": "COLUMBUS",
"state": "OH",
"zipOrPostalCode": "43215",
"country": "US",
"countryISOCode": "",
"geoPosition": {
"latitude": 35.6312866,
"longitude": -97.494186
}
},
"seedInput": {
"companyName": "Bold Penguin Inc.",
"address": {
"streetAddr": "100 East Broad St",
"city": "Columbud",
"state": "OH",
"zipOrPostalCode": "43215",
"country": "US"
}
}
},
"data": {
"company_id": "CUSDD97T2FAE114E52240",
"company_name": "BOLD PENGUIN INC.",
"dba_aka": [],
"phone_number": "6143441029",
"website": "https://www.boldpenguin.com/",
"email_id": "hello@boldpenguin.com",
"address": "100 EAST BROAD ST",
"city": "COLUMBUS",
"state": "OH",
"postal_code": "43215",
"duns_number": "",
"primary_naics_2017": [
{
"code": "111111",
"desc": "Awesome Insurance Companies"
}
],
"secondary_naics_2017": [
{
"code": "999999",
"desc": "Insurance Partners"
},
],
"year_founded": "2016",
"annual_revenue": "500.0",
"annual_payroll": "500.0",
"total_full_time_employees": "250",
"total_employees_at_this_location": "250",
"primary_naics_2012": [
{
"code": "111111",
"desc": "Awesome Insurance Companies"
}
],
"secondary_naics_2012": [
{
"code": "999999",
"desc": "Insurance Partners"
}
],
"parent_company_revenue": "500.0",
"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/v3/penguin-us-l0001/LUS1187A2AAE214FBF35
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: M4jHKvQ6dD4Y1sDiv7gEe6LIuqArhDin8XldfxoK
Authorization: Bearer NMav128jTZbbEK48o64UM94K

Sample Location Data Inquiry Response

{
"tx_id": "penguin-hu769dua-45ty-3ria-4444-82dhjakl87",
"tx_start_time": "2022-06-03T20:49:09.493Z",
"tx_end_time": "2022-06-03T20:49:09.933Z",
"response_time_secs": "0",
"data_package_id": "penguin-us-l0000",
"tenant_id": "penguin",
"user_id": "0715308c-db1c-4e63-b854-779bc93bc77c",
"c_report_id": "CUSDD97T2FAE114E52240",
"l_report_id": "LUS1387Y3Y8256746FC9",
"seed_input": {
"company_name": "Bold Penguin Inc.",
"address": "100 East Broad St, 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 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"
}
}
},
"data": {
"location_id": "LUS61F4Y2AE1410UBF35",
"location_address": "100 EAST BROAD ST",
"location_city": "COLUMBUS",
"location_state": "OH",
"location_postal_code": "43215",
"location_country": "US",
"latitude": "39.963070",
"longitude": "-82.997600",
"construction_type": "ICE",
"construction_quality": "GREAT",
"smart_construction_code": 3,
"total_lot_size_sqft": "8000",
"total_building_area_sqft": "7200",
"total_floors": "100",
"owner_name": "",
"land_use_code": "PENGUIN"
},
"scores": {
"location_address": "69.90",
"location_city": "69.90",
"location_state": "69.90",
"location_postal_code": "69.90",
"location_country": "69.90",
"latitude": "75.59",
"longitude": "75.59",
"construction_type": "80.64",
"construction_quality": "80.64",
"smart_construction_code": "80.64",
"total_lot_size_sqft": "80.64",
"total_building_area_sqft": "80.64",
"total_floors": "78.19",
"land_use_code": "80.64"
}
}

Get Enriched Company 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 get a transactionId which can be used to get the extracted & enriched data post document processing.

Endpoint

Staging

GET https://api-smartdata.di-beta.boldpenguin.com/data/v3/{dp_id}/{tx_id}?idType=transaction

Production

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

Pass the below variables as part of the request

Request ParametersComments
Authentication TokenThe token obtained in STEP 1
API Key(Shared with the Customer)
dp_id(Data Package ID Shared with the Customer)
tx_idThis Id is returned as part of the Universal Submit response
idTypequery parameter idType=transaction

Sample Company Data Inquiry Request

GET /data/v3/kowalski-us-c0006/9fb6b3fe-5e90-4610-a2ab-dbea6656dd0e?idType=transaction HTTP/1.1
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: M4jHKvQ6dD4Y1sDiv7gEe6LIuqArhDin8XldfxoK
Authorization: Bearer NMav128jTZbbEK48o64UM94K

Sample Company Data Inquiry Response

{
"tx_id": "kowalski-hu769dua-45ty-3ria-4444-82dhjakl87",
"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": "kowalski",
"c_report_id": "CUSDD97T2FAE114E52240",
"l_report_id": "LUS1387Y3Y8256746FC9",
"doc_reference_id": "9fb6b3fe-5e90-4610-a2ab-dbea6656dd0e",
"seed_input": {
"company_name": "Bold Penguin Inc.",
"address": "100 East Broad St, 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": "888888888"
},
"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": "888888888",
"legal_entity_type": "Corporation",
"year_founded": "2016",
"annual_revenue": "500.0",
"bankruptcy_indicator": "N",
"smart_company_credit_grade": "A",
"primary_naics_2012": [
{
"code": "111111",
"desc": "Awesome Insurance Companies"
}
],
"secondary_naics_2012": [
{
"code": "999999",
"desc": "Insurance Partners"
}
],
"company_number": "",
"has_company_been_liquidated": "",
"company_jurisdiction": "",
"insolvency_history": "",
"country": "US",
"global_ultimate_duns": "",
"company_description": [
"At Bold Penguin, our singular goal is to help carriers, agents, and small businesses get insurance policies much, much faster. To do this, we must continue to deliver the preeminent digital infrastructure to power small business insurance transactions in the United States. "
],
"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": "11PA",
"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": "2023-04-01",
"field_office": "",
"exclusive_flag": "N",
"end_date": "",
"document_date": "2023-03-12",
"broker_contact_points": "First Name Last Name",
"coverage": [],
"100_pct_limit": "",
"broker_name": "",
"underwriter": "",
"broker_address": "",
"broker_city": "",
"broker_postal_code": "",
"broker_state": "",
"broker_email": "hello@boldpenguin.com",
"estimated_premium": "500.0",
"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"
}
}

Get Enriched Location Data Using Transaction ID

  • Prerequisite: The documents ( eml , pdf, word-docs, excel ) containing SOV (statement of values) data are submitted via the Universal Submit API. As part of the response to universal submit we will get a transactionId which can be used to get the extracted & enriched data post document processing.

Endpoint

Staging

GET https://api-smartdata.di-beta.boldpenguin.com/data/v3/{dp_id}/{tx_id}?idType=sov

Production

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

Pass the below variables as part of the request

Request ParametersComments
Authentication TokenThe token obtained in STEP 1
API Key(Shared with the Customer)
dp_id(Data Package ID Shared with the Customer)
tx_idThis Id is returned as part of the Universal Submit response
idTypequery parameter idType=sov

Sample Location Data Inquiry Request

GET /data/v3/kowalski-us-l0006/7f782ee1-805c-41b7-9b8e-ea698d9a42c0?idType=sov HTTP/1.1
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: M4jHKvQ6dD4Y1sDiv7gEe6LIuqArhDin8XldfxoK
Authorization: Bearer NMav128jTZbbEK48o64UM94K

Sample Location Data Inquiry Response

{
"tx_id": "kowalski-hu769dua-45ty-3ria-4444-82dhjakl87",
"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": "jkasd789-45ty-xa34-12dc-a4a240bk141",
"l_report_id": "",
"doc_reference_id": "9fb6b3fe-5e90-4610-a2ab-dbea6656dd0e",
"data": [
{
"facts": {
"location_id": "LUS61F4Y2AE1410UBF35",
"location_address": "100 East 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": 1800,
"total_floors": ""
},
"options": {
"location_doc_id": "1000-USA-Peng",
"location_name": "",
"location_county": "",
"building_value": "500.00",
"personal_property_value": "500",
"business_interruption_value": "",
"stock_tiv": "0",
"location_application_limit": "500"
},
"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"
}
},
....
....
]
}

Get Claims Boudreaux Data Using Transaction ID

  • Prerequisite: The documents ( eml , pdf, word-docs, excel ) containing claims boudreaux data are submitted via the Universal Submit API. As part of the response to universal submit we will get a transactionId which can be used to get the extracted & enriched data post document processing.

Endpoint

Staging

GET https://api-smartdata.di-beta.boldpenguin.com/data/v3/{dp_id}/{tx_id}?idType=claim_bdx

Production

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

Pass the below variables as part of the request

Request ParametersComments
Authentication TokenThe token obtained in STEP 1
API Key(Shared with the Customer)
dp_id(Data Package ID Shared with the Customer)
tx_idThis Id is returned as part of the Universal Submit response
idTypequery parameter idType=claim_bdx

Sample Company Data Inquiry Request

GET /data/v3/kowalski-claims-c0001/1605b463-c6d7-4751-84d4-c62f3ae98203?idType=claim_bdx HTTP/1.1
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: M4jHKvQ6dD4Y1sDiv7gEe6LIuqArhDin8XldfxoK
Authorization: Bearer NMav128jTZbbEK48o64UM94K

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": "jkasd789-45ty-xa34-12dc-a4a240bk141",
"doc_reference_id": "9fb6b3fe-5e90-4610-a2ab-dbea6656dd0e",
"data": [
{
"options": {
"policy_number": "123456789",
"insured_name": "BOLD PENGUIN INC.",
"date_of_loss": "16/02/2020",
"loss_number": "111111 (5)",
"claim_amount_currency": "",
"claim_already_paid_amount": 500.0,
"claim_to_be_paid_amount": 500.0,
"claim_reserve": 0,
"claim_incurred": "",
"loss_description": "Fish went bad before being eaten by Penguin Team"
},
"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"
}
}
....
....
]
}

Get Premium Boudreaux Data Using Transaction Id

  • Prerequisite: The documents ( eml , pdf, word-docs, excel ) containing premium boudreaux data are submitted via the Universal Submit API. As part of the response to universal submit we will get a transactionId which can be used to get the extracted & enriched data post document processing.

Endpoint

Staging

GET https://api-smartdata.di-beta.boldpenguin.com/data/v3/{dp_id}/{tx_id}?idType=prem_bdx

Production

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

Pass the below variables as part of the request

Request ParametersComments
Authentication TokenThe token obtained in STEP 1
API Key(Shared with the Customer)
dp_id(Data Package ID Shared with the Customer)
tx_idThis Id is returned as part of the Universal Submit response
idTypequery parameter idType=prem_bdx

Sample Premium Data Inquiry Request

GET /data/v3/kowalski-prem-c0001/1605b463-c6d7-4751-84d4-c62f3ae98203?idType=prem_bdx HTTP/1.1
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: M4jHKvQ6dD4Y1sDiv7gEe6LIuqArhDin8XldfxoK
Authorization: Bearer NMav128jTZbbEK48o64UM94K

Sample Premium Data Inquiry Response

{
"tx_id": "3dc5ae22-3908-4cb9-b71e-31aeed886658",
"tx_start_time": "2022-05-18T19:43:33.675Z",
"tx_end_time": "2022-05-18T19:43:38.388Z",
"response_time_secs": "4",
"data_package_id": "kowalski-prem-c0001",
"tenant_id": "kowalski",
"user_id": "jkasd789-45ty-xa34-12dc-a4a240bk141",
"doc_reference_id": "9fb6b3fe-5e90-4610-a2ab-dbea6656dd0e",
"data": [
{
"options": {
"reinsured_cedent": "Bold Penguin Inc.",
"policy_number": "6103111111440",
"risk_country": [
"Antarctica"
],
"name_of_risk": "",
"policy_inception_date": "2021-04-01",
"policy_expiration_date": "2025-04-01",
"total_sum_insured": 500.0,
"reinsurance_share": 8862.937672,
"gross_premium": 500.0,
"reinsurance_gross_premium_share_currency": "EUR"
},
"facts": {
"industry_segment_or_client_occupancy": ""
},
"scores": {
"reinsured_cedent": "85.16",
"policy_expiration_date": "85.16",
"total_sum_insured": "85.16",
"reinsurance_share": "85.16",
"gross_premium": "85.16",
"reinsurance_gross_premium_share_currency": "85.16"
}
}
.....
.....
]
}