[POST] - Bulk Company Fetch API

  • Updated

Use the Bulk Company Fetch endpoint to retrieve company details. You can pass a maximum of 50 companyIds to retrieve their details.

Endpoint

POST https://api.insideview.com/api/v1/company/bulk

Request

HTTP Headers

Header Name Type Required Description
accessToken String Yes The valid access token.
See Authentication and Authorization Overview for more details.
Accept String No Selects the response's content type.  
Valid values are application/json and application/xml (default).  
Content-Type String Required Application/JSON

Request Body

The request body should contain an array of company ids in JSON format separated with commas. The request can contain up to 50 company ids. 

Note: Bulk Company Fetch APIs accept only “companyIds" array If you enter duplicate IDs only one ID is accepted. If you enter Alphanumeric IDs, an invalid error is returned. If the Company IDs are not present in the database, the “company not present” error appears.

Example input data

{
  "companyIds": ["2546544", "hfdjjdjkd", "2546544", "1416385f" ,"1750717", "1750717", "757321768" , "1456802" ]
}


Responses

HTTP 200

Returns either a JSON or XML data structure depending on the request Accept header. 

Note: Some fields might require additional permissions to returned in the response.

Name type Description
requestedCompanyId String Requested company ID
city String  Company address: city 
companyId Integer Company InsideView id
currentCompanyId Integer Current company Id
companyStatus String Company status (Operating, Subsidiary, ...)
companyType String Company type (Private, Public, Subsidiary)
country String Company address: country 
foundationDate String Foundation date of the company
gender String Diversity status based on Gender
ethnicity String Diversity status based on Ethnicity
dbe Boolean Diversity status based on Disadvantages Business Ent. 
wbe  Boolean Diversity status based on Women Business Ent. 
mbe  Boolean Diversity status based on Minority Business Ent. 
vbe  Boolean Diversity status based on Veteran Business Ent.
disabled  Boolean Diversity status based on Disabled Business Ent. 
lgbt Boolean Diversity status based on Gay Lesbian business Ent. 
companyTaxId String US company Tax Id (if available)
employees String  Company employee count 
employeeRange String Range of number of employees
equifaxId Integer Company Equifax id
fax String Company fax number
financialYearEnd String Company financial year end month
industry String Company industry 
industryCode String Company industry code.
naics String Company NAICS code
naicsDescription String Company NAICS description
name String Company name
parentCompanyId String Parent company InsideView id
parentCompanyName String Parent company name
parentCompanyCountry String Parent company country
phone String Company phone number
revenue String Company revenue (Millions of $)
revenueCurrency String Company revenue's currency (USD, EUR, GBP)
revenueRange String Revenue range of the company
sic String Company SIC code
sicDescription String Company SIC description
sources List List of sources for company attributes (String)
state String Company address: state
street String Company address: street
subIndustry String Company sub-industry
subIndustryCode String Company sub-industry code
subsidiary Boolean Indicates wether the company is a subsidiary or not.
tickers Array Array of company's tickers details
tickers tickerName String  Ticker symbol 
tickers exchange  String  Exchange symbol
ultimateParentCompanyId String Ultimate parent company InsideView id
ultimateParentCompanyName String Ultimate parent company name
ultimateParentCompanyCountry String Ultimate parent company country
zip String Company address: zip code 
websites List List of company's web site URL (String)
britishSics List  List of British SIC Codes
britishSics britishSic String British SIC code
britishSics description String  British SIC code description
mostRecentQuarter String Most Recent Quarter Earning Date
companyFacebookProfile String Facebook profile of Company
companyTwitterProfile String  Twitter profile of Company
companyBlogProfile  String  Blog Url link of Company
companyLinkedInProfile  String LinkedIn profile of Company

businessStructure

String

The organizational structure of a company (globalParent, uncategorized, subsidiary, group, independent) 

companyStatusV2

String

Company status (operating, non-Operating, acquired, liquidating, outOfBusiness, unassigned

companyTypeV2

String

Company type (public, private, government, organization, unknown)

siteCount

String

Number of company sites

siteLocationCount

String

Number of company sites that has site related information

siteTypes

String

Type of a site

 

application/json example

[
{
"requestedCompanyId": "2546544",
"company": {
"name": "Google LLC",
"companyType": "Private",
"companyStatus": "Subsidiary",
"industry": "Media",
"subIndustry": "Internet Search and Navigation Services",
"street": "1600 Amphitheatre Pkwy",
"city": "Mountain View",
"state": "CA",
"zip": "94043",
"country": "United States",
"phone": "+1 650 253 0000",
"revenue": "182000.0",
"employees": "135301",
"subsidiary": "true",
"sic": "7375",
"sicDescription": "Information Retrieval Services",
"naics": "5192",
"naicsDescription": "Web Search Portals, Libraries, Archives, and Other Information Services",
"parentCompanyId": "736233",
"ultimateParentId": "736233",
"equifaxId": "029154375",
"revenueCurrency": "USD",
"industryCode": "23",
"subIndustryCode": "23_8",
"britishSics": [
{
"britishSic": "63990",
"description": "Other information service activities n.e.c."
}
],
"parentCompanyCountry": "United States",
"ultimateParentCompanyCountry": "United States",
"ultimateParentCompanyName": "Alphabet Inc",
"parentCompanyName": "Alphabet Inc",
"foundationDate": "1998",
"companyFacebookProfile": "https://www.facebook.com/104958162837",
"companyTwitterProfile": "https://twitter.com/Google",
"companyBlogProfile": "https://www.blog.google/rss",
"companyLinkedInProfile": "https://www.linkedin.com/company/google",
"latitude": "37.422031",
"longitude": "-122.084327",
"currentCompanyId": 7573216,
"businessStructure": "Subsidiary",
"companyTypeV2": "Private",
"companyStatusV2": "Operating",
"siteTypes": [
"Uncategorized"
],
"companyId": 2546544,
"websites": [
"www.google.com"
],
"sources": [
"User Generated",
"Web References",
"InsideView",
"Community",
"Equifax"
]
}
},
{
"requestedCompanyId": "hfdjjdjkd",
"error": {
"errorCode": "400-102",
"errorMessage": "Company Id is not valid."
}
},
{
"requestedCompanyId": "1416385f",
"error": {
"errorCode": "400-102",
"errorMessage": "Company Id is not valid."
}
},
{
"requestedCompanyId": "1750717",
"company": {
"name": "Google India Pvt Ltd",
"companyType": "Private",
"companyStatus": "Subsidiary",
"industry": "Media",
"subIndustry": "Internet Search and Navigation Services",
"street": "No 3 Rmz Infinity - Tower E Old Madras Road 3rd, 4th, And 5th Floors",
"city": "Bengaluru",
"state": "Karnataka",
"zip": "560016",
"country": "India",
"phone": "+91 80672 18000",
"employees": "8000",
"subsidiary": "true",
"sic": "7375",
"sicDescription": "Information Retrieval Services",
"naics": "519290",
"naicsDescription": "Web Search Portals and All Other Information Services",
"parentCompanyId": "7573216",
"ultimateParentId": "736233",
"industryCode": "23",
"subIndustryCode": "23_8",
"britishSics": [
{
"britishSic": "63990",
"description": "Other information service activities n.e.c."
}
],
"parentCompanyCountry": "United States",
"ultimateParentCompanyCountry": "United States",
"ultimateParentCompanyName": "Alphabet Inc",
"parentCompanyName": "Google LLC",
"foundationDate": "2003",
"companyTwitterProfile": "https://twitter.com/IndiaToday",
"companyBlogProfile": "http://picasaweb.google.com/data/feed/base/user/109046633736305531422?alt=rss&kind=album&hl=en_US&access=public&imgmax=1600",
"businessStructure": "Subsidiary",
"companyTypeV2": "Private",
"companyStatusV2": "Operating",
"siteTypes": [
"Uncategorized"
],
"companyId": 1750717,
"websites": [
"https://www.google.co.in"
],
"sources": [
"Web References",
"InsideView",
"Community"
]
}
},
{
"requestedCompanyId": "757321768",
"error": {
"errorCode": "404-601",
"errorMessage": "company not present."
}
},
{
"requestedCompanyId": "1456802",
"company": {
"name": "Google Australia Pty. Ltd.",
"companyType": "Private",
"companyStatus": "Subsidiary",
"industry": "Corporate Services",
"subIndustry": "Advertising Agencies",
"street": "Level 5 48 Pirrama Road",
"city": "Sydney",
"state": "NSW",
"zip": "2009",
"country": "Australia",
"phone": "+61 2 9374 4000",
"employees": "350",
"subsidiary": "true",
"sic": "7311",
"sicDescription": "Services-Advertising Agencies",
"naics": "541810",
"naicsDescription": "Advertising Agencies",
"parentCompanyId": "7573216",
"ultimateParentId": "736233",
"industryCode": "12",
"subIndustryCode": "12_1",
"britishSics": [
{
"britishSic": "73110",
"description": "Advertising agencies"
}
],
"parentCompanyCountry": "United States",
"ultimateParentCompanyCountry": "United States",
"ultimateParentCompanyName": "Alphabet Inc",
"parentCompanyName": "Google LLC",
"foundationDate": "2002",
"companyBlogProfile": "http://picasaweb.google.com/data/feed/base/user/tzuyun1123/albumid/5345150043729291601?alt=rss&kind=photo&hl=en_US",
"businessStructure": "Subsidiary",
"companyTypeV2": "Private",
"companyStatusV2": "Operating",
"siteTypes": [
"Uncategorized"
],
"companyId": 1456802,
"websites": [
"https://www.google.com.au/?gws_rd=ssl"
],
"sources": [
"Web References",
"InsideView"
]
}
}
]

application/xml example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<companyResponseDTOes>
<companyDetail>
<company>
<companyId>2546544</companyId>
<websites>
<website>www.google.com</website>
</websites>
<sources>
<source>User Generated</source>
<source>Web References</source>
<source>InsideView</source>
<source>Community</source>
<source>Equifax</source>
</sources>
<britishSics>
<britishSicDetails>
<britishSic>63990</britishSic>
<description>Other information service activities n.e.c.</description>
</britishSicDetails>
</britishSics>
<siteTypes>
<siteType>Uncategorized</siteType>
</siteTypes>
<businessStructure>Subsidiary</businessStructure>
<city>Mountain View</city>
<companyBlogProfile>https://www.blog.google/rss</companyBlogProfile>
<companyFacebookProfile>https://www.facebook.com/104958162837</companyFacebookProfile>
<companyLinkedInProfile>https://www.linkedin.com/company/google</companyLinkedInProfile>
<companyStatus>Subsidiary</companyStatus>
<companyStatusV2>Operating</companyStatusV2>
<companyTwitterProfile>https://twitter.com/Google</companyTwitterProfile>
<companyType>Private</companyType>
<companyTypeV2>Private</companyTypeV2>
<country>United States</country>
<currentCompanyId>7573216</currentCompanyId>
<employees>135301</employees>
<equifaxId>029154375</equifaxId>
<foundationDate>1998</foundationDate>
<industry>Media</industry>
<industryCode>23</industryCode>
<latitude>37.422031</latitude>
<longitude>-122.084327</longitude>
<naics>5192</naics>
<naicsDescription>Web Search Portals, Libraries, Archives, and Other Information Services</naicsDescription>
<name>Google LLC</name>
<parentCompanyCountry>United States</parentCompanyCountry>
<parentCompanyId>736233</parentCompanyId>
<parentCompanyName>Alphabet Inc</parentCompanyName>
<phone>+1 650 253 0000</phone>
<revenue>182000.0</revenue>
<revenueCurrency>USD</revenueCurrency>
<sic>7375</sic>
<sicDescription>Information Retrieval Services</sicDescription>
<state>CA</state>
<street>1600 Amphitheatre Pkwy</street>
<subIndustry>Internet Search and Navigation Services</subIndustry>
<subIndustryCode>23_8</subIndustryCode>
<subsidiary>true</subsidiary>
<ultimateParentCompanyCountry>United States</ultimateParentCompanyCountry>
<ultimateParentCompanyName>Alphabet Inc</ultimateParentCompanyName>
<ultimateParentId>736233</ultimateParentId>
<zip>94043</zip>
</company>
<requestedCompanyId>2546544</requestedCompanyId>
</companyDetail>
<companyDetail>
<error>
<errorCode>400-102</errorCode>
<errorMessage>Company Id is not valid.</errorMessage>
</error>
<requestedCompanyId>hfdjjdjkd</requestedCompanyId>
</companyDetail>
<companyDetail>
<error>
<errorCode>400-102</errorCode>
<errorMessage>Company Id is not valid.</errorMessage>
</error>
<requestedCompanyId>1416385f</requestedCompanyId>
</companyDetail>
<companyDetail>
<company>
<companyId>1750717</companyId>
<websites>
<website>https://www.google.co.in</website>
</websites>
<sources>
<source>Web References</source>
<source>InsideView</source>
<source>Community</source>
</sources>
<britishSics>
<britishSicDetails>
<britishSic>63990</britishSic>
<description>Other information service activities n.e.c.</description>
</britishSicDetails>
</britishSics>
<siteTypes>
<siteType>Uncategorized</siteType>
</siteTypes>
<businessStructure>Subsidiary</businessStructure>
<city>Bengaluru</city>
<companyBlogProfile>http://picasaweb.google.com/data/feed/base/user/109046633736305531422?alt=rss&amp;kind=album&amp;hl=en_US&amp;access=public&amp;imgmax=1600</companyBlogProfile>
<companyStatus>Subsidiary</companyStatus>
<companyStatusV2>Operating</companyStatusV2>
<companyTwitterProfile>https://twitter.com/IndiaToday</companyTwitterProfile>
<companyType>Private</companyType>
<companyTypeV2>Private</companyTypeV2>
<country>India</country>
<employees>8000</employees>
<foundationDate>2003</foundationDate>
<industry>Media</industry>
<industryCode>23</industryCode>
<naics>519290</naics>
<naicsDescription>Web Search Portals and All Other Information Services</naicsDescription>
<name>Google India Pvt Ltd</name>
<parentCompanyCountry>United States</parentCompanyCountry>
<parentCompanyId>7573216</parentCompanyId>
<parentCompanyName>Google LLC</parentCompanyName>
<phone>+91 80672 18000</phone>
<sic>7375</sic>
<sicDescription>Information Retrieval Services</sicDescription>
<state>Karnataka</state>
<street>No 3 Rmz Infinity - Tower E Old Madras Road 3rd, 4th, And 5th Floors</street>
<subIndustry>Internet Search and Navigation Services</subIndustry>
<subIndustryCode>23_8</subIndustryCode>
<subsidiary>true</subsidiary>
<ultimateParentCompanyCountry>United States</ultimateParentCompanyCountry>
<ultimateParentCompanyName>Alphabet Inc</ultimateParentCompanyName>
<ultimateParentId>736233</ultimateParentId>
<zip>560016</zip>
</company>
<requestedCompanyId>1750717</requestedCompanyId>
</companyDetail>
<companyDetail>
<error>
<errorCode>404-601</errorCode>
<errorMessage>company not present.</errorMessage>
</error>
<requestedCompanyId>757321768</requestedCompanyId>
</companyDetail>
<companyDetail>
<company>
<companyId>1456802</companyId>
<websites>
<website>https://www.google.com.au/?gws_rd=ssl</website>
</websites>
<sources>
<source>Web References</source>
<source>InsideView</source>
</sources>
<britishSics>
<britishSicDetails>
<britishSic>73110</britishSic>
<description>Advertising agencies</description>
</britishSicDetails>
</britishSics>
<siteTypes>
<siteType>Uncategorized</siteType>
</siteTypes>
<businessStructure>Subsidiary</businessStructure>
<city>Sydney</city>
<companyBlogProfile>http://picasaweb.google.com/data/feed/base/user/tzuyun1123/albumid/5345150043729291601?alt=rss&amp;kind=photo&amp;hl=en_US</companyBlogProfile>
<companyStatus>Subsidiary</companyStatus>
<companyStatusV2>Operating</companyStatusV2>
<companyType>Private</companyType>
<companyTypeV2>Private</companyTypeV2>
<country>Australia</country>
<employees>350</employees>
<foundationDate>2002</foundationDate>
<industry>Corporate Services</industry>
<industryCode>12</industryCode>
<naics>541810</naics>
<naicsDescription>Advertising Agencies</naicsDescription>
<name>Google Australia Pty. Ltd.</name>
<parentCompanyCountry>United States</parentCompanyCountry>
<parentCompanyId>7573216</parentCompanyId>
<parentCompanyName>Google LLC</parentCompanyName>
<phone>+61 2 9374 4000</phone>
<sic>7311</sic>
<sicDescription>Services-Advertising Agencies</sicDescription>
<state>NSW</state>
<street>Level 5 48 Pirrama Road</street>
<subIndustry>Advertising Agencies</subIndustry>
<subIndustryCode>12_1</subIndustryCode>
<subsidiary>true</subsidiary>
<ultimateParentCompanyCountry>United States</ultimateParentCompanyCountry>
<ultimateParentCompanyName>Alphabet Inc</ultimateParentCompanyName>
<ultimateParentId>736233</ultimateParentId>
<zip>2009</zip>
</company>
<requestedCompanyId>1456802</requestedCompanyId>
</companyDetail>
</companyResponseDTOes>

HTTP 400

Company Id is not valid.

HTTP 401

Unauthorized Error - Cannot use API's without setting a valid accessToken in header.

HTTP 405

Method Not Allowed - HTTP method other than POST is not allowed.

HTTP 404

Invalid ID, record not present. company not present.

HTTP 429

Request is throttled.