[GET] - New Company Details

  • Updated

Use the New Company Details endpoint to fetch details about a company once you know its new company id. You can choose to retrieve all or some of the details of the company.

Endpoint

GET https://api.insideview.com/api/v1/target/companies/{newCompanyId}

Request

HTTP Headers

Header Name Type Required Description
accessToken String Yes 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).  
Accept-Language String No Select the response's language and locale.
Default value: en-en
See Internationalization Support for more details.

URI Parameters

Parameter Name Type Required Description
newCompanyId String Yes New Company ID

Query Parameters

Parameter Name Type Required Description
fields String No Comma separated list of fields to include in the response.
Use this parameter if you are interested in only a few fields, to reduce the amount of data retrieved.
Ex:  fields=name,sic,naics,companyType

Responses

HTTP 200

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

Name type Description
city String  Company address: city 
companyId Integer Company InsideView ID
companyStatus String Company status (Operating, Subsidiary, ...)
companyType String Company type (Private, Public, Subsidiary)
country String Company address: country 
employees String  Company employee count 
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)
sic String Company SIC code
sicDescription String Company SIC description
employeeRange String Range of number of employees
revenueRange String Range of company revenue
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)
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.
ticker Array Array of company's tickers details
ticker tickerName String  Ticker symbol 
ticker 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 Earnings 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, 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

{
"name": "Microsoft Corporation",
"companyType": "Public",
"companyStatus": "Operating",
"tickers": [
{
"tickerName": "GOOG",
"exchange": "NASD"
}
],
"industry": "Computer Software",
"subIndustry": "Computer Software",
"street": "One Microsoft Way, Redmond",
"city": "Redmond",
"state": "WA",
"zip": "98052-6399",
"country": "United States",
"phone": "+1 425 882 8080",
"revenue": "89960.0",
"employees": "6002",
"subsidiary": "false",
"description": "Microsoft Corporation, an American multinational technology company headquartered in Redmond, Washington, that develops, manufactures, licenses, supports and sells computer software, consumer electronics and personal computers and services. Its software products includes the Microsoft Windows line of operating systems, Microsoft Office office suite, and Edge web browser. Its flagship hardware products includes the Xbox game consoles and the Microsoft Surface tablet lineup. It also offers cloud-based solutions that provide customers with software, services, and content over the Internet by way of shared computing resources located in centralized data centers. It also designs and sells hardware, including PCs, tablets, gaming and entertainment consoles, phones, other intelligent devices, and related accessories.",
"sic": "7372",
"sicDescription": "Prepackaged Software",
"financialYearEnd": "4",
"equifaxId": "049615062",
"fortuneRanking": "28",
"mostRecentQuarter": "Jun, 2017",
"revenueCurrency": "USD",
"industryCode": "7",
"subIndustryCode": "7",
"britishSics": [
{
"britishSic": "46510",
"description": "Wholesale of computers, computer peripheral equipment and software"
},
{
"britishSic": "58210",
"description": "Publishing of computer games"
},
{
"britishSic": "62011",
"description": "Ready-made interactive leisure and entertainment software development"
},
{
"britishSic": "58290",
"description": "Other software publishing"
}
],
"foundationDate": "1975",
"companyTaxId": "911144442",
"companyFacebookProfile": "https://www.facebook.com/118644529988713",
"companyTwitterProfile": "https://twitter.com/Microsoft",
"companyBlogProfile": "108761330653186",
"companyLinkedInProfile": "https://www.linkedin.com/company/108761330653186",
"siteCount": 288,
"siteLocationCount": 82,
"businessStructure": "Global Parent",
"companyTypeV2": "Public",
"companyStatusV2": "Operating",
"companyId": 726263,
"websites": [
"https://www.microsoft.com/en-us/"
],
"siteTypes": [
"Uncategorized"
],
"sources": [
"User Generated",
"Web References",
"Reuters",
"InsideView",
"Community",
"Equifax"
]
}

application/xml example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<company>
<companyId>726263</companyId>
<tickers>
<ticker>
<exchange>NASD</exchange>
<tickerName>GOOG</tickerName>
</ticker>
</tickers>
<websites>
<website>https://www.microsoft.com/en-us/</website>
</websites>
<sources>
<source>User Generated</source>
<source>Web References</source>
<source>Reuters</source>
<source>InsideView</source>
<source>Community</source>
<source>Equifax</source>
</sources>
<britishSics>
<britishSicDetails>
<britishSic>46510</britishSic>
<description>Wholesale of computers, computer peripheral equipment and software</description>
</britishSicDetails>
<britishSicDetails>
<britishSic>58210</britishSic>
<description>Publishing of computer games</description>
</britishSicDetails>
<britishSicDetails>
<britishSic>62011</britishSic>
<description>Ready-made interactive leisure and entertainment software development</description>
</britishSicDetails>
<britishSicDetails>
<britishSic>58290</britishSic>
<description>Other software publishing</description>
</britishSicDetails>
</britishSics>
<siteTypes>
<siteType>Uncategorized</siteType>
</siteTypes>
<businessStructure>Global Parent</businessStructure>
<city>Redmond</city>
<companyBlogProfile>108761330653186</companyBlogProfile>
<companyFacebookProfile>https://www.facebook.com/118644529988713</companyFacebookProfile>
<companyLinkedInProfile>https://www.linkedin.com/company/108761330653186</companyLinkedInProfile>
<companyStatus>Operating</companyStatus>
<companyStatusV2>Operating</companyStatusV2>
<companyTaxId>911144442</companyTaxId>
<companyTwitterProfile>https://twitter.com/Microsoft</companyTwitterProfile>
<companyType>Public</companyType>
<companyTypeV2>Public</companyTypeV2>
<country>United States</country>
<description>Microsoft Corporation, an American multinational technology company headquartered in Redmond, Washington, that develops, manufactures, licenses, supports and sells computer software, consumer electronics and personal computers and services. Its software products includes the Microsoft Windows line of operating systems, Microsoft Office office suite, Edge web browser. Its flagship hardware products includes the Xbox game consoles and the Microsoft Surface tablet lineup. It also offers cloud-based solutions that provide customers with software, services, and content over the Internet by way of shared computing resources located in centralized data centers. It also designs and sells hardware, including PCs, tablets, gaming and entertainment consoles, phones, other intelligent devices, and related accessories.</description>
<employees>6002</employees>
<equifaxId>049615062</equifaxId>
<financialYearEnd>4</financialYearEnd>
<fortuneRanking>28</fortuneRanking>
<foundationDate>1975</foundationDate>
<industry>Computer Software</industry>
<industryCode>7</industryCode>
<mostRecentQuarter>Jun, 2017</mostRecentQuarter>
<name>Microsoft Corporation</name>
<phone>+1 425 882 8080</phone>
<revenue>89960.0</revenue>
<revenueCurrency>USD</revenueCurrency>
<sic>7372</sic>
<sicDescription>Prepackaged Software</sicDescription>
<siteCount>288</siteCount>
<siteLocationCount>82</siteLocationCount>
<state>WA</state>
<street>One Microsoft Way, Redmond</street>
<subIndustry>Computer Software</subIndustry>
<subIndustryCode>7</subIndustryCode>
<subsidiary>false</subsidiary>
<zip>98052-6399</zip>
</company>

HTTP 400

Invalid query parameter(s).

HTTP 401

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

HTTP 405

Method Not Allowed - Your are not allowed to access this API.

HTTP 404

Invalid ID, record not found.

HTTP 429

Request is throttled.