[POST] - Company List (List Build)

Use the Target API's Company List endpoint to build a list a companies using rich filters.

The elements in the companies list contain a newid value and enough additional information such that a user could narrow down a selection from the list. Using the selected newid values you can retrieve additional company information through the Target API's New Company Details endpoint.

Note: Please use filters to limit the list size to below 100K per API call.

Endpoint

POST https://api.insideview.com/api/v1/target/companies

Request

HTTP Headers

Form Parameters

pageIntegerNoDefault: 1

Responses

Here are the major responses the API may return.

for details on the errors, please refer to the API Error Codes article.

HTTP 200

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

application/json Example

{
  "companies": [
    {
      "country": "United States",
      "employees": 750,
      "fiscalYearEnd": "0",
      "industry": "Corporate Services",
      "subIndustry": "Management Consulting",
      "revenue": "43.75",
      "sic": "8742",
      "naics": "541611",
      "companyType": "Private",
      "id": "3Qi2YsBVHeHgnxwhQHdwsmxxBCVh6xKgTcNVU2YEmGcq60UWkbROad4U-Ac3YzqU",
      "companyId": "728051", 
      "city": "Boston",
      "companyStatus": "Operating",
      "naicsDescription": "Administrative Management and General Management Consulting Services",
      "sicDescription": "Services-Management Consulting Services",
      "state": "MA",
      "subsidiary": "Operating",
      "companyIdMd5Hash": "073fafb94b63aeb67e769c0c1269e64c",
      "revenueCurrency": "USD",
      "industryCode": "12",
      "subIndustryCode": "12_19",
      "zip": "02199",
      "name": "Analysis Group, Inc.",
      "britishSics": [
        {
          "britishSic": "70229",
          "description": "Management consultancy activities other than financial management"
        },
        {
          "britishSic": "71122",
          "description": "Engineering related scientific and technical consulting activities"
        }
      ],
      "companyFacebookProfile": "AnalysisGroupConsulting",
      "companyTwitterProfile": "analysisgroup",
      "companyBlogProfile": "whsSQLi",
      "companyLinkedInProfile": "analysis-group"
      "website": "www.analysisgroup.com'  
    },
    {
      "country": "United States",
      "employees": 3066,
      "fiscalYearEnd": "0",
      "industry": "Computer Software",
      "subIndustry": "Development Tools and Utilities Software",
      "revenue": "700.0",
      "sic": "7371",
      "naics": "511210",
      "companyType": "Private",
      "id": "Ff24HpXMDjFXZSAw7mYEozINOfJoBBxagtWPbNHpwrMoEInBH81ik-aVCLVe0xYK",
      "companyId": 2853339"
      "city": "Detroit",
      "companyStatus": "Operating",
      "naicsDescription": "Software Publishers",
      "sicDescription": "Services-Computer Programming Services",
      "state": "MI",
      "subsidiary": "Operating",
      "companyIdMd5Hash": "9233b68f3ab250a880dda79400024785",
      "revenueCurrency": "USD",
      "industryCode": "8",
      "subIndustryCode": "8_24",
      "zip": "48226",
      "name": "Compuware Corporation",
      "britishSics": [
        {
          "britishSic": "62012",
          "description": "Business and domestic software development"
        }
      ],
      "companyFacebookProfile": "compuware",
      "companyTwitterProfile": "compuware",
      "companyBlogProfile": "http://apps.shareholder.com/rss/rss.aspx?channels=5785&companyid=CPWR&sh_auth=0.0.0.ad1dcb691ef81696c0c02ea27e385165",
      "companyLinkedInProfile": "compuware"
      "website": "www.compuware.com"
    }
  ],
  "totalResults": "12419465",
  "page": "1",
  "resultsPerPage": "2"
}

application/xml Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<companyList>
    <companies>
        <country>United States</country>
        <employees>750</employees>
        <fiscalYearEnd>0</fiscalYearEnd>
        <industry>Corporate Services</industry>
        <subIndustry>Management Consulting</subIndustry>
        <revenue>43.75</revenue>
        <sic>8742</sic>
        <naics>541611</naics>
        <companyType>Private</companyType>
        <id>3Qi2YsBVHeHgnxwhQHdwsmxxBCVh6xKgTcNVU2YEmGcq60UWkbROad4U-Ac3YzqU</id>
        <companyId>728051</companyId>
        <city>Boston</city>
        <companyStatus>Operating</companyStatus>
        <naicsDescription>Administrative Management and General Management Consulting Services</naicsDescription>
        <sicDescription>Services-Management Consulting Services</sicDescription>
        <state>MA</state>
        <subsidiary>Operating</subsidiary>
        <companyIdMd5Hash>073fafb94b63aeb67e769c0c1269e64c</companyIdMd5Hash>
        <revenueCurrency>USD</revenueCurrency>
        <industryCode>12</industryCode>
        <subIndustryCode>12_19</subIndustryCode>
        <zip>02199</zip>
        <name>Analysis Group, Inc.</name>
        <britishSics>
            <britishSicDetails>
                <britishSic>70229</britishSic>
                <description>Management consultancy activities other than financial management</description>
            </britishSicDetails>
            <britishSicDetails>
                <britishSic>71122</britishSic>
                <description>Engineering related scientific and technical consulting activities</description>
            </britishSicDetails>
        </britishSics>
        <companyFacebookProfile>AnalysisGroupConsulting</companyFacebookProfile>
        <companyTwitterProfile>analysisgroup</companyTwitterProfile>
        <companyBlogProfile>whsSQLi</companyBlogProfile>
        <companyLinkedInProfile>analysis-group</companyLinkedInProfile>
        <websites>www.analysisgroup.com</websites>
    </companies>

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 429

Request is throttled.