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 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 Company Submit API.

Step 2: Access the Company Submit URL

Endpoint

Staging

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

Production

POST 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 in STEP 1
API Key	(Shared with the Customer)
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

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

Production

GET 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 in STEP 1
API Key	(Shared with the Customer)
dp_id	(Data Package Id shared with the Customer)
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"
    }
}