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.