Company Submit

Description

When provided with a company name and company address, the Company Submit API will trigger the process to aggregate relevant data from multiple data sources. The output of the API is a unique Company ID which can be used later to retrieve the company data.

Authentication

Step 1: Obtain a Bearer Token

The Company Submit 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 Universal Submit 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).

Step 2: Access the Company Submit URL

Endpoint

Staging

https://api-smartdata.di-beta.boldpenguin.com/company/v1/company_submit

Production

https://api.ii.boldpenguin.com/company/v1/company_submit

Pass the following variables as part of the request

Request Parameters	Comments
Authentication Token	The token obtained via the Authentication API
API Key	(Provided by Bold Penguin)
POST Request Body	The body contains a JSON message which will have Company Name and Address attributes

Sample Company Submit Request

POST /company/v1/company_submit HTTP/1.1
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: M4jHKvQ6dD4Y1sDiv7gEe6LIuqArhDin8XldfxoK
Authorization: Bearer NMav128jTZbbEK48o64UM94K
Content-Type: application/json
Content-Length: 119

{
    "company_name":"Bold Penguin Inc.",
    "address":"100 East Broad St, Columbus, OH 43215"
}

Sample Company Submit Response

{
    "tx_id": "kowalski-c723d830-5222-4c16-8a15-077e2b3d439b",
    "tenant_id": "kowalski",
    "user_id": "jkasd789-45ty-xa34-12dc-a4a240bk141",
    "tx_start_time": "2021-05-13T14:27:40.447841+00:00",
    "tx_end_time": "2021-05-13T14:27:42.345011+00:00",
    "response_time_secs": 1.896377,
    "seed_input": {
        "company_name": "Bold Penguin Inc.",
        "address": "100 East Broad St, Columbus, OH 43215"
    },
    "c_report_id": "CUSDD97T2FAE114E52240",
    "l_report_id": "LUS1387Y3Y8256746FC9"
}

Access the Data API

Step 3: Data Inquiry URL

Endpoint

Staging

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

Production

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

Pass the following variables as part of the request

Request Parameters	Comments
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	This Id is returned as part of the Company Submit response (c_report_id)

Sample Data Inquiry Request

GET /data/v1/kowalski-us-c0001/CUS1187A2AAE214E4540 HTTP/1.1
Host: api-smartdata.di-beta.boldpenguin.com
x-api-key: M1jEEv7cVDAY1sDeFAgEe6LTuqArh99n8XldfxoK
Authorization: Bearer 1Vr29n7q19PWstA4Knk2vHE3
Note: kowalski-us-c0001 is the sample dp_id used above

Sample Data Inquiry Response

{
    "tx_id": "kowalski-8bd82aba-7d01-42d4-b851-b0bea1b41540",
    "tenant_id": "kowalski",
    "user_id": "jkasd789-45ty-xa34-12dc-a4a240bk141",
    "tx_start_time": "2021-05-13T20:51:52.362Z",
    "tx_end_time": "2021-05-13T20:51:54.310Z",
    "response_time_secs": 6.778006,
    "seed_input": {
               "company_name": "Bold kowalski Inc.",
               "address": "100 East Broad St, Columbus, OH 43215"
    },
    "data_package_id": "kowalski-us-c0001",
    "c_report_id": "CUSDD97T2FAE114E52240",
    "l_report_id": "LUS1387Y3Y8256746FC9",
    "cleansed_input": {
                "companyName": "BOLD PENGUIN INC.",
                "website": "https://www.boldpenguin.com/",
                "phoneNumber": "6143441029",
                "confidence_score": 0.6,
                "address": {
                  "streetAddr": "100 EAST BROAD ST",
                  "city": "COLUMBUS",
                  "state": "OH",
                  "zipOrPostalCode": "43215",
                  "country": "US",
                  "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": ""
                  }
                }
    },
    "data": {
              "company_id": "CUS1187A2AAE214E4540",
              "company_name": "BOLD PENGUIN INC.",
              "dba_aka": [],
              "contact_name": [],
              "phone_number": "1-6143441029",
              "website": "https://www.boldpenguin.com/",
              "email_id": "",
              "address": "100 East Broad St",
              "city": "Columbus",
              "state": "OH",
              "postal_code": "43215",
              "fein": "",
              "legal_entity_type": "",
             "year_founded": "2016",
              "year_in_business": 21,
              "annual_revenue": "6657967",
              "annual_payroll": "1163503.72",
              "total_full_time_employees": "250",
              "primary_naics_2012": [{
                    "code": "111111",
                    "desc": "Awesome Insurance Companies"
            }],
 "secondary_naics_2012": [{
                     "code": "238170",
                     "desc": "Flashing contractors"
            },{
                     "code": "238170",
                     "desc": "Siding contractors"
            },{
                     "code": "238220",
                     "desc": "plumbing, heating, and air-conditioning contractors"
            },{
                     "code": "236220",
                     "desc": "commercial and institutional building construction"
            }],
              "country": "US",
              "company_description": [],
              "ppp_loan_size": ""
    },
    "scores": {
            "website": "86.21",
            "year_founded": "72.84",
            "year_in_business": "72.84",
            "annual_revenue": "69.90",
            "annual_payroll": "80.64",
            "total_full_time_employees": "80.64",
            "primary_naics_2012": "75.59"
    }
}