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"
}
}