Use the Company Details endpoint to fetch details about a company once you know its id. You can choose to retrieve all or some of the details of the company.
The company id can be obtained either through the Data API Company Search or through the Enrich API Enrich (or its bulk version).
Endpoint
GET https://api.insideview.com/api/v1/company/{companyId}
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 |
companyId | String | Yes | 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.
Note: Some fields might require additional permissions to returned in the response.
Name | type | Description |
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 |
latitude | String | Latitude point of the company location |
longitude | String | Longitude point of the company location |
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 |
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "/",
"type": "object",
"properties": {
"name": {
"id": "name",
"type": "string"
},
"companyType": {
"id": "companyType",
"type": "string"
},
"companyStatus": {
"id": "companyStatus",
"type": "string"
},
"tickers": {
"id": "tickers",
"type": "array",
"items": {
"id": "0",
"type": "object",
"properties": {
"tickerName": {
"id": "tickerName",
"type": "string"
},
"exchange": {
"id": "exchange",
"type": "string"
}
}
},
"additionalProperties": false
},
"industry": {
"id": "industry",
"type": "string"
},
"subIndustry": {
"id": "subIndustry",
"type": "string"
},
"street": {
"id": "street",
"type": "string"
},
"city": {
"id": "city",
"type": "string"
},
"state": {
"id": "state",
"type": "string"
},
"zip": {
"id": "zip",
"type": "string"
},
"country": {
"id": "country",
"type": "string"
},
"phone": {
"id": "phone",
"type": "string"
},
"fax": {
"id": "fax",
"type": "string"
},
"revenue": {
"id": "revenue",
"type": "string"
},
"employees": {
"id": "employees",
"type": "string"
},
"subsidiary": {
"id": "subsidiary",
"type": "string"
},
"sic": {
"id": "sic",
"type": "string"
},
"sicDescription": {
"id": "sicDescription",
"type": "string"
},
"naics": {
"id": "naics",
"type": "string"
},
"naicsDescription": {
"id": "naicsDescription",
"type": "string"
},
"financialYearEnd": {
"id": "financialYearEnd",
"type": "string"
},
"parentCompanyId": {
"id": "parentCompanyId",
"type": "string"
},
"ultimateParentId": {
"id": "ultimateParentId",
"type": "string"
},
"equifaxId": {
"id": "equifaxId",
"type": "string"
},
"fortuneRanking": {
"id": "fortuneRanking",
"type": "string"
},
"mostRecentQuarter": {
"id": "mostRecentQuarter",
"type": "string"
},
"revenueCurrency": {
"id": "revenueCurrency",
"type": "string"
},
"industryCode": {
"id": "industryCode",
"type": "string"
},
"subIndustryCode": {
"id": "subIndustryCode",
"type": "string"
},
"britishSics": {
"id": "britishSics",
"type": "array",
"items": {
"id": "0",
"type": "object",
"properties": {
"britishSic": {
"id": "britishSic",
"type": "string"
},
"description": {
"id": "description",
"type": "string"
}
}
},
"uniqueItems": true,
"additionalProperties": false
},
"parentCompanyCountry": {
"id": "parentCompanyCountry",
"type": "string"
},
"ultimateParentCompanyCountry": {
"id": "ultimateParentCompanyCountry",
"type": "string"
},
"ultimateParentCompanyName": {
"id": "ultimateParentCompanyName",
"type": "string"
},
"parentCompanyName": {
"id": "parentCompanyName",
"type": "string"
},
"revenueRange": {
"id": "revenueRange",
"type": "string"
},
"employeeRange": {
"id": "employeeRange",
"type": "string"
},
"foundationDate": {
"id": "foundationDate",
"type": "string"
},
"latitude": {
"id": "latitude",
"type": "string"
},
"longitude": {
"id": "longitude",
"type": "string"
},
"companyFacebookProfile": {
"id": "companyFacebookProfile",
"type": "string"
},
"companyTwitterProfile": {
"id": "companyTwitterProfile",
"type": "string"
},
"companyBlogProfile": {
"id": "companyBlogProfile",
"type": "string"
},
"companyLinkedInProfile": {
"id": "companyLinkedInProfile",
"type": "string"
},
"gender": {
"id": "gender",
"type": "string"
},
"ethnicity": {
"id": "ethnicity",
"type": "string"
},
"dbe": {
"id": "dbe",
"type": "boolean"
},
"wbe": {
"id": "wbe",
"type": "boolean"
},
"mbe": {
"id": "mbe",
"type": "boolean"
},
"vbe": {
"id": "vbe",
"type": "boolean"
},
"lgbt": {
"id": "lgbt",
"type": "boolean"
},
"disabled": {
"id": "disabled",
"type": "boolean"
},
"companyTaxId": {
"id": "companyTaxId",
"type": "string"
},
"websites": {
"id": "websites",
"type": "array",
"items": {
"id": "0",
"type": "string"
},
"uniqueItems": true
},
"companyId": {
"id": "companyId",
"type": "integer"
},
"sources": {
"id": "sources",
"type": "array",
"items": {
"id": "0",
"type": "string"
}
},
"businessStructure": {
"id": "businessStructure",
"type": "string"
},
"companyStatusV2": {
"id": "companyStatusV2",
"type": "string"
},
"companyTypeV2": {
"id": "companyTypeV2",
"type": "string"
},
"siteTypes": {
"id": "siteTypes",
"type": "array",
"items": {
"id": "0",
"type": "string"
}
},
"siteCount": {
"id": "siteCount",
"type": "integer"
},
"siteLocationCount": {
"id": "siteLocationCount",
"type": "integer"
},
"currentCompanyId": {
"id": "currentCompanyId",
"type": "integer"
}
},
"additionalProperties": false
}
Example
{
"name": "Apple Inc.",
"companyType": "Public",
"companyStatus": "Operating",
"tickers": [
{
"tickerName": "AAPL",
"exchange": "NASD"
}
],
"industry": "Computer Hardware",
"subIndustry": "Computer Hardware",
"street": "1 Infinite Loop",
"city": "CUPERTINO",
"state": "CA",
"zip": "95014-2083",
"country": "United States",
"phone": "1-408-9961010",
"revenue": "267683.0",
"employees": "137000",
"subsidiary": "false",
"sic": "3663",
"sicDescription": "Radio and Television Broadcasting and Communications Equipment",
"naics": "335210",
"naicsDescription": "Small Electrical Appliance Manufacturing",
"financialYearEnd": "9",
"fortuneRanking": "3",
"revenueCurrency": "USD",
"industryCode": "6",
"subIndustryCode": "6",
"britishSics": [
{
"britishSic": "46510",
"description": "Wholesale of computers, computer peripheral equipment and software"
},
{
"britishSic": "26200",
"description": "Manufacture of computers and peripheral equipment"
}
],
"foundationDate": "1976",
"companyTwitterProfile": "https://twitter.com/AppleTV",
"companyBlogProfile": "http://time.com/3965742/husband-smoking-google-street-view/feed/",
"companyLinkedInProfile": "https://www.linkedin.com/company/apple",
"latitude": "37.3316917419434",
"longitude": "-122.030235290527",
"siteTypes": [
"Uncategorized"
],
"siteCount": 500,
"siteLocationCount": 268,
"businessStructure": "globalParent",
"companyTypeV2": "Public",
"companyStatusV2": "Operating",
"companyId": 724468,
"websites": [
"https://www.apple.com/"
]
}
Type: application/xml
Schema
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="company" type="companyDTO"/>
<xs:complexType name="companyDTO">
<xs:sequence>
<xs:element name="companyId" type="xs:int" minOccurs="0"/>
<xs:element name="tickers" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="ticker" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="exchange" type="xs:string" minOccurs="0"/>
<xs:element name="tickerName" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="websites" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="website" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sources" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="source" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="siteTypes" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="siteType" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="britishSics" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element name="britishSicDetails" minOccurs="0" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="britishSic" type="xs:string" minOccurs="0"/>
<xs:element name="description" type="xs:string" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="companyStatusV2" type="xs:string" minOccurs="0"/>
<xs:element name="companyTypeV2" type="xs:string" minOccurs="0"/>
<xs:element name="businessStructure" type="xs:string" minOccurs="0"/>
<xs:element name="siteCount" type="xs:int" minOccurs="0"/>
<xs:element name="siteLocationCount" type="xs:int" minOccurs="0"/>
<xs:element name="city" type="xs:string" minOccurs="0"/>
<xs:element name="companyBlogProfile" type="xs:string" minOccurs="0"/>
<xs:element name="companyFacebookProfile" type="xs:string" minOccurs="0"/>
<xs:element name="companyLinkedInProfile" type="xs:string" minOccurs="0"/>
<xs:element name="companyStatus" type="xs:string" minOccurs="0"/>
<xs:element name="companyTwitterProfile" type="xs:string" minOccurs="0"/>
<xs:element name="companyTaxId" type="xs:string" minOccurs="0"/>
<xs:element name="companyType" type="xs:string" minOccurs="0"/>
<xs:element name="country" type="xs:string" minOccurs="0"/>
<xs:element name="dbe" type="xs:boolean" minOccurs="0"/>
<xs:element name="lgbt" type="xs:boolean" minOccurs="0"/>
<xs:element name="disabled" type="xs:boolean" minOccurs="0"/>
<xs:element name="employeeRange" type="xs:string" minOccurs="0"/>
<xs:element name="employees" type="xs:string" minOccurs="0"/>
<xs:element name="equifaxId" type="xs:string" minOccurs="0"/>
<xs:element name="ethnicity" type="xs:string" minOccurs="0"/>
<xs:element name="fax" type="xs:string" minOccurs="0"/>
<xs:element name="financialYearEnd" type="xs:string" minOccurs="0"/>
<xs:element name="fortuneRanking" type="xs:string" minOccurs="0"/>
<xs:element name="foundationDate" type="xs:string" minOccurs="0"/>
<xs:element name="gender" type="xs:string" minOccurs="0"/>
<xs:element name="industry" type="xs:string" minOccurs="0"/>
<xs:element name="industryCode" type="xs:string" minOccurs="0"/>
<xs:element name="latitude" type="xs:string" minOccurs="0"/>
<xs:element name="longitude" type="xs:string" minOccurs="0"/>
<xs:element name="mbe" type="xs:boolean" minOccurs="0"/>
<xs:element name="mostRecentQuarter" type="xs:string" minOccurs="0"/>
<xs:element name="naics" type="xs:string" minOccurs="0"/>
<xs:element name="naicsDescription" type="xs:string" minOccurs="0"/>
<xs:element name="name" type="xs:string" minOccurs="0"/>
<xs:element name="parentCompanyCountry" type="xs:string" minOccurs="0"/>
<xs:element name="parentCompanyId" type="xs:string" minOccurs="0"/>
<xs:element name="parentCompanyName" type="xs:string" minOccurs="0"/>
<xs:element name="phone" type="xs:string" minOccurs="0"/>
<xs:element name="revenue" type="xs:string" minOccurs="0"/>
<xs:element name="revenueCurrency" type="xs:string" minOccurs="0"/>
<xs:element name="revenueRange" type="xs:string" minOccurs="0"/>
<xs:element name="sic" type="xs:string" minOccurs="0"/>
<xs:element name="sicDescription" type="xs:string" minOccurs="0"/>
<xs:element name="state" type="xs:string" minOccurs="0"/>
<xs:element name="street" type="xs:string" minOccurs="0"/>
<xs:element name="subIndustry" type="xs:string" minOccurs="0"/>
<xs:element name="subIndustryCode" type="xs:string" minOccurs="0"/>
<xs:element name="subsidiary" type="xs:string" minOccurs="0"/>
<xs:element name="ultimateParentCompanyCountry" type="xs:string" minOccurs="0"/>
<xs:element name="ultimateParentCompanyName" type="xs:string" minOccurs="0"/>
<xs:element name="ultimateParentId" type="xs:string" minOccurs="0"/>
<xs:element name="vbe" type="xs:boolean" minOccurs="0"/>
<xs:element name="wbe" type="xs:boolean" minOccurs="0"/>
<xs:element name="zip" type="xs:string" minOccurs="0"/>
<xs:element name="currentCompanyId" type="xs:int" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<company>
<companyId>724468</companyId>
<tickers>
<ticker>
<exchange>NASD</exchange>
<tickerName>AAPL</tickerName>
</ticker>
</tickers>
<websites>
<website>https://www.apple.com/</website>
</websites>
<sources/>
<siteTypes>
<siteType>Uncategorized</siteType>
</siteTypes>
<britishSics>
<britishSicDetails>
<britishSic>46510</britishSic>
<description>Wholesale of computers, computer peripheral equipment and software</description>
</britishSicDetails>
<britishSicDetails>
<britishSic>26200</britishSic>
<description>Manufacture of computers and peripheral equipment</description>
</britishSicDetails>
</britishSics>
<companyStatusV2>Operating</companyStatusV2>
<companyTypeV2>Public</companyTypeV2>
<businessStructure>globalParent</businessStructure>
<siteCount>500</siteCount>
<siteLocationCount>268</siteLocationCount>
<city>CUPERTINO</city>
<companyBlogProfile>http://time.com/3965742/husband-smoking-google-street-view/feed/</companyBlogProfile>
<companyLinkedInProfile>https://www.linkedin.com/company/apple</companyLinkedInProfile>
<companyStatus>Operating</companyStatus>
<companyTwitterProfile>https://twitter.com/AppleTV</companyTwitterProfile>
<companyType>Public</companyType>
<country>United States</country>
<employees>137000</employees>
<financialYearEnd>9</financialYearEnd>
<fortuneRanking>3</fortuneRanking>
<foundationDate>1976</foundationDate>
<industry>Computer Hardware</industry>
<industryCode>6</industryCode>
<latitude>37.3316917419434</latitude>
<longitude>-122.030235290527</longitude>
<naics>335210</naics>
<naicsDescription>Small Electrical Appliance Manufacturing</naicsDescription>
<name>Apple Inc.</name>
<phone>1-408-9961010</phone>
<revenue>267683.0</revenue>
<revenueCurrency>USD</revenueCurrency>
<sic>3663</sic>
<sicDescription>Radio and Television Broadcasting and Communications Equipment</sicDescription>
<state>CA</state>
<street>1 Infinite Loop</street>
<subIndustry>Computer Hardware</subIndustry>
<subIndustryCode>6</subIndustryCode>
<subsidiary>false</subsidiary>
<zip>95014-2083</zip>
</company>
HTTP 400
Invalid query parameter(s).
HTTP 401
Unauthorized Error - Cannot use API's without setting a valid accessToken in header.
HTTP 404
Invalid ID, record not found.
HTTP 405
Method Not Allowed - Your are not allowed to access this API.
HTTP 429
Request is throttled.