[POST] - Bulk Company Fetch API – InsideView

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 (global parent, uncategorized, subsidiary, group, branch, 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 Inc.",
            "companyType": "Private",
            "companyStatus": "Subsidiary",
            "industry": "Media",
            "subIndustry": "Internet Search and Navigation Services",
            "street": "1600 Amphitheatre Pkwy ",
            "city": "Mountain View",
            "state": "CA",
            "zip": "94043-1351",
            "country": "United States",
            "phone": "+1 650 253 0000",
            "revenue": "74541.0",
            "subsidiary": "true",
            "description": "Google is a global technology leader focused on improving the ways people connect with information. 
            Google’s innovations in web search and advertising have made its website a top internet property and its brand one 
            of the most recognized in the world.",
            "sic": "7375",
            "sicDescription": "Information Retrieval Services",
            "parentCompanyId": "736233",
            "ultimateParentId": "736233",
            "equifaxId": "029154375",
            "revenueCurrency": "USD",
            "industryCode": "23",
            "subIndustryCode": "23_15",
            "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",
            "companyTwitterProfile": "google",
            "latitude": "37.4220314025879",
            "longitude": "-122.084327697754",
            "currentCompanyId": 7573216,
            "sources": [
                "User Generated",
                "InsideView",
                "Community",
                "Equifax"
            ],
            "companyId": 2546544,
            "websites": [
                "http://www.google.com"
            ]
        }
    },
    {
        "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 Private Limited",
            "companyType": "Private",
            "companyStatus": "Subsidiary",
            "industry": "Computer Software",
            "subIndustry": "Collaborative Software",
            "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 80 6721 8989",
            "subsidiary": "true",
            "description": "Google India Private Limited operates as an online search engine. 
            The company provides access to online information. It also serves as a platform for users to use as vehicles for 
            social networking, video engagement, mailing and blogging. The company was founded in 2004 and is based in Bengaluru, 
            India. Google India Private Limited operates as a subsidiary of Google Inc.",
            "sic": "7371",
            "sicDescription": "Computer Programming Services",
            "naics": "519130",
            "naicsDescription": "Internet Publishing and Broadcasting and Web Search Portals",
            "parentCompanyId": "736233",
            "ultimateParentId": "736233",
            "industryCode": "7",
            "subIndustryCode": "7_13",
            "britishSics": [
                {
                    "britishSic": "62012",
                    "description": "Business and domestic software development"
                }
            ],
            "parentCompanyCountry": "United States",
            "ultimateParentCompanyCountry": "United States",
            "ultimateParentCompanyName": "Alphabet Inc",
            "parentCompanyName": "Alphabet Inc",
            "foundationDate": "2003",
            "companyTwitterProfile": "IndiaToday",
            "companyBlogProfile": "http://picasaweb.google.com/data/feed/base/user/109046633736305531422?alt=rss&kind=album&hl=en_US&access=public&imgmax=1600",
            "sources": [
                "Web References",
                "InsideView",
                "S&P Global",
                "Community"
            ],
            "companyId": 1750717,
            "websites": [
                "https://www.google.co.in"
            ]
        }
    },
    {
        "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": "Sales Promotion",
            "street": "48 Pirrama Road Level 5 Pyrmont",
            "city": "Sydney",
            "state": "New South Wales",
            "country": "Australia",
            "employees": "350",
            "subsidiary": "true",
            "description": "Google Australia Pty Limited markets and sells internet search, advertising, and information management 
            technology services and related products. The company also provides services, assistance, and advice in connection with 
            marketing and sales support for web search engine and advertising. In addition, it offers research and development 
            support services for Google technologies; and sells hardware. The company was incorporated in 2002 and is based in 
            Sydney, Australia. Google Australia Pty Limited is a subsidiary of Google International LLC.",
            "sic": "7374",
            "sicDescription": "Computer Processing and Data Preparation and Processing Services",
            "naics": "541810",
            "naicsDescription": "Advertising Agencies",
            "parentCompanyId": "736233",
            "ultimateParentId": "736233",
            "industryCode": "11",
            "subIndustryCode": "11_41",
            "britishSics": [
                {
                    "britishSic": "47990",
                    "description": "Other retail sale not in stores, stalls or markets"
                },
                {
                    "britishSic": "73110",
                    "description": "Advertising agencies"
                }
            ],
            "parentCompanyCountry": "United States",
            "ultimateParentCompanyCountry": "United States",
            "ultimateParentCompanyName": "Alphabet Inc",
            "parentCompanyName": "Alphabet Inc",
            "foundationDate": "2002",
            "companyBlogProfile": "http://picasaweb.google.com/data/feed/base/user/tzuyun1123/albumid/5345150043729291601?alt=rss&kind=photo&hl=en_US",
            "sources": [
                "Web References",
                "InsideView",
                "S&P Global"
            ],
            "companyId": 1456802,
            "websites": [
                "www.google.com.au"
            ]
        }
    }
]

application/xml example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<companyResponseDTOes>
<companyDetail>
<company>
    <companyId>2546544</companyId>
    <websites>
    <website>http://www.google.com</website>
    </websites>
    <sources>
        <source>User Generated</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>
        <city>Mountain View</city>
         <companyStatus>Subsidiary</companyStatus>
        <companyTwitterProfile>google</companyTwitterProfile>
       <companyType>Private</companyType>
    <country>United States</country>
    <currentCompanyId>7573216</currentCompanyId>
        <description>Go<dogle is a global technology leader focused on improving the ways people connect with information. Google’s innovations in
web search and advertising have made its website a top internet property and its brand one of the most recognized in the world.</description> <description>Wholesale of computers, computer peripheral equipment and software</description> 
<equifaxId>029154375</equifaxId> 
<foundationDate>1998</foundationDate> 
<industry>Media</industry> 
<industryCode>23</industryCode> 
<latitude>37.4220314025879</latitude>  
<longitude>-122.084327697754</longitude> 
<name>Google Inc.</name> 
<parentCompanyCountry>United States</parentCompanyCountry> 
<companyFacebookProfile>615085188507202</companyFacebookProfile> 
<parentCompanyId>736233</parentCompanyId> 
<parentCompanyName>Alphabet Inc</parentCompanyName> 
<phone>+1 650 253 0000</phone> 
<revenue>74541.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_15</subIndustryCode> 
<ultimateParentCompanyCountry>United States</ultimateParentCompanyCountry> 
<ultimateParentCompanyName>Alphabet Inc</ultimateParentCompanyName>
<ultimateParentCompanyName>Alphabet Inc</ultimateParentCompanyName> <zip>94043-1351</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>S&amp;P Global</source>
       <source>Community</source>
    </sources>
    <britishSics>
    <britishSicDetails>
   <britishSic>62012</britishSic>
   <description>Business and domestic software development</description>
   </britishSicDetails>
   </britishSics>
   <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>
   <companyTwitterProfile>IndiaToday</companyTwitterProfile>
   <companyType>Private</companyType>
   <country>India</country>
   <description>Google India Private Limited operates as an online search engine. 
   The company provides access to online information. It also serves as a platform 
   for users to use as vehicles for social networking, video engagement, mailing 
   and blogging. The company was founded in 2004 and is based in Bengaluru, India. 
   Google India Private Limited operates as a subsidiary of Google Inc.</description>
   <foundationDate>2003</foundationDate>
   <industry>Computer Software</industry>
   <industryCode>7</industryCode>
   <naics>519130</naics>
   <naicsDescription>Internet Publishing and Broadcasting and Web Search Portals</naicsDescription>
   <name>Google India Private Limited</name>
   <parentCompanyCountry>United States</parentCompanyCountry>
   <parentCompanyId>736233</parentCompanyId>
   <parentCompanyName>Alphabet Inc</parentCompanyName>
   <phone>91 80 6721 8989</phone>
   <sic>7371</sic>
   <sicDescription>Computer Programming Services</sicDescription>
   <state>Karnataka</state>
   <street>No 3 Rmz Infinity - Tower E Old Madras Road 3rd, 4th, And 5th Floors</street>
   <subIndustry>Collaborative Software</subIndustry>
   <subIndustryCode>7_13</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>www.google.com.au</website>
</websites>
<sources>
<source>Web References</source>
<source>InsideView</source>
<source>S&amp;P Global</source>
</sources>
 <britishSics>
 <britishSicDetails>
 <britishSic>47990</britishSic>
 <description>Other retail sale not in stores, stalls or markets</description>
</britishSicDetails>
<britishSicDetails>
<britishSic>73110</britishSic>
 <description>Advertising agencies</description>
 </britishSicDetails>
</britishSics>
<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>
<companyType>Private</companyType>
<country>Australia</country>
<description>Google Australia Pty Limited markets and sells internet search, advertising, and information management technology services 
and related products. The company also provides services, assistance, and advice in connection with marketing and sales support for web search engine
and advertising. In addition, it offers research and development support services for Google technologies; and sells hardware. The company was 
incorporated in 2002 and is based in Sydney, Australia. Google Australia Pty Limited is a subsidiary of Google International LLC.</description>
<employees>350</employees>
<foundationDate>2002</foundationDate>
 <industry>Corporate Services</industry>
<industryCode>11</industryCode>
<naics>541810</naics>
<naicsDescription>Advertising Agencies</naicsDescription>
<name>Google Australia Pty. Ltd.</name>
<parentCompanyCountry>United States</parentCompanyCountry>
<parentCompanyId>736233</parentCompanyId>
<parentCompanyName>Alphabet Inc</parentCompanyName>
<sic>7374</sic>
<sicDescription>Computer Processing and Data Preparation and Processing Services</sicDescription>
<state>New South Wales</state>
<street>48 Pirrama Road Level 5 Pyrmont</street>
 <subIndustry>Sales Promotion</subIndustry>
<subIndustryCode>11_41</subIndustryCode>
 <subsidiary>true</subsidiary>
 <ultimateParentCompanyCountry>United States</ultimateParentCompanyCountry>
<ultimateParentCompanyName>Alphabet Inc</ultimateParentCompanyName>
<ultimateParentId>736233</ultimateParentId>
 </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.

Articles in this section

[POST] - Bulk Company Fetch API