Skip to main content

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 ParametersComments
Authentication TokenThe token obtained in STEP 1
API Key(Shared with the Customer)
POST Request BodyThe 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 ParametersComments
Authentication TokenThe token obtained in STEP 1
API Key(Shared with the Customer)
dp_id(Data Package Id shared with the Customer)
report_idThis 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"
}
}