[POST] - Company Lookup

Use the Company lookup endpoint to build a list of company names along with company ID, city, state and country 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.

Endpoint

POST https://api.insideview.com/api/v1/target/company/lookup

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",
      "companyType": "Public",
      "id": "xA6BNZPztenSEsPIC5z5CWJzT1lxWDSqHMiQcdEtEV0RXFk6wW_4CsnagoE7v-So",
      "city": "Redmond",
      "name": "Microsoft Corporation"
    },
    {
      "country": "United States",
      "companyType": "Public",
      "id": "xA6BNZPztenSEsPIC5z5CQsolUy-BvDgv8LFj0CguKwYpiFCYCW_zA3ADNCjvGiA",
      "city": "Palo Alto",
      "state": "CA",
      "name": "jal"
    },
    {
      "country": "United States",
      "companyType": "Public",
      "id": "544KN90XokCKSBrKF8FkXyMHadZtrZeN_RNMHQN4RH2GAssErlMCTgex4fChKOCs",
      "city": "New York",
      "state": "NY",
      "name": "jal"
    },
    {
      "country": "United States",
      "companyType": "Public",
      "id": "xA6BNZPztenSEsPIC5z5CWbSSngPgwVFQaS_xIFzcidFRj654SH-jJtcQsa4JEMx",
      "city": "Stamford",
      "state": "CT",
      "name": "jal"
    },
    {
      "country": "United States",
      "companyType": "Private",
      "id": "NARi-O8bFmNgeOopr2cauoIr1s1SDMUEzN5QNoGOZM8mSXLljXs4hSpkwTPy-fGb",
      "city": "Santa Clara",
      "state": "CA",
      "name": "Avaya Inc."
    },
    {
      "country": "United States",
      "companyType": "Public",
      "id": "xA6BNZPztenSEsPIC5z5CXIEGj4kQiQPN7najTHApEPNX2_fMTQ6-8anEffcMcMm",
      "city": "Armonk",
      "state": "NY",
      "name": "jal"
    },
    {
      "country": "United States",
      "companyType": "Public",
      "id": "xA6BNZPztenSEsPIC5z5CUBXQ2FnKCE2O0xdLEb9OwXyP-U9ySlHRRp5CYdT9nBc",
      "city": "San Jose",
      "state": "CA",
      "name": "jal"
    },
    {
      "country": "Singapore",
      "companyType": "Private",
      "id": "xA6BNZPztenSEsPIC5z5CeyvGtRVB51rGgcoxoLinYgpBr1f4gPXPm-ky_zrD7VJ",
      "city": "Singapore",
      "name": "United Test and Assembly Center Ltd."
    },
    {
      "country": "United States",
      "companyType": "Public",
      "id": "xA6BNZPztenSEsPIC5z5CTtjMbCJXKYYlIkGVK_uh-YnDPSU_xCT3m69VUuBhhMa",
      "city": "Fairfield",
      "state": "CT",
      "name": "jal"
    },
    {
      "country": "United States",
      "companyType": "Public",
      "id": "544KN90XokCKSBrKF8FkXxS_LZNylp7GUlLlsdxS6XEcjP4O-TdOAX081_LauNMB",
      "city": "Charlotte",
      "state": "NC",
      "name": "jal"
    }
  ],
  "totalResults": "499",
  "page": "1",
  "resultsPerPage": "10"
}

application/xml Example

<?xml version="1.0" encoding="UTF-8"?>
<companyList>
 <companies>
 <country>United States</country>
 <companyType>Public</companyType>
 <id>xA6BNZPztenSEsPIC5z5CWJzT1lxWDSqHMiQcdEtEV0RXFk6wW_4CsnagoE7v-So</id>
 <city>Redmond</city>
 <state></state>
 <name>Microsoft Corporation</name>
 </companies>
 <companies>
 <country>United States</country>
 <companyType>Public</companyType>
 <id>xA6BNZPztenSEsPIC5z5CQsolUy-BvDgv8LFj0CguKwYpiFCYCW_zA3ADNCjvGiA</id>
 <city>Palo Alto</city>
 <state>CA</state>
 <name>jal</name>
 </companies>
 <companies>
 <country>United States</country>
 <companyType>Public</companyType>
 <id>544KN90XokCKSBrKF8FkXyMHadZtrZeN_RNMHQN4RH2GAssErlMCTgex4fChKOCs</id>
 <city>New York</city>
 <state>NY</state>
 <name>jal</name>
 </companies>
 <companies>
 <country>United States</country>
 <companyType>Public</companyType>
 <id>xA6BNZPztenSEsPIC5z5CWbSSngPgwVFQaS_xIFzcidFRj654SH-jJtcQsa4JEMx</id>
 <city>Stamford</city>
 <state>CT</state>
 <name>jal</name>
 </companies>
 <companies>
 <country>United States</country>
 <companyType>Private</companyType>
 <id>NARi-O8bFmNgeOopr2cauoIr1s1SDMUEzN5QNoGOZM8mSXLljXs4hSpkwTPy-fGb</id>
 <city>Santa Clara</city>
 <state>CA</state>
 <name>Avaya Inc.</name>
 </companies>
 <companies>
 <country>United States</country>
 <companyType>Public</companyType>
 <id>xA6BNZPztenSEsPIC5z5CXIEGj4kQiQPN7najTHApEPNX2_fMTQ6-8anEffcMcMm</id>
 <city>Armonk</city>
 <state>NY</state>
 <name>jal</name>
 </companies>
 <companies>
 <country>United States</country>
 <companyType>Public</companyType>
 <id>xA6BNZPztenSEsPIC5z5CUBXQ2FnKCE2O0xdLEb9OwXyP-U9ySlHRRp5CYdT9nBc</id>
 <city>San Jose</city>
 <state>CA</state>
 <name>jal</name>
 </companies>
 <companies>
 <country>Singapore</country>
 <companyType>Private</companyType>
 <id>xA6BNZPztenSEsPIC5z5CeyvGtRVB51rGgcoxoLinYgpBr1f4gPXPm-ky_zrD7VJ</id>
 <city>Singapore</city>
 <name>United Test and Assembly Center Ltd.</name>
 </companies>
 <companies>
 <country>United States</country>
 <companyType>Public</companyType>
 <id>xA6BNZPztenSEsPIC5z5CTtjMbCJXKYYlIkGVK_uh-YnDPSU_xCT3m69VUuBhhMa</id>
 <city>Fairfield</city>
 <state>CT</state>
 <name>jal</name>
 </companies>
 <companies>
 <country>United States</country>
 <companyType>Public</companyType>
 <id>544KN90XokCKSBrKF8FkXxS_LZNylp7GUlLlsdxS6XEcjP4O-TdOAX081_LauNMB</id>
 <city>Charlotte</city>
 <state>NC</state>
 <name>jal</name>
 </companies>
 <page>1</page>
 <totalResults>499</totalResults>
</companyList>

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.