[POST] - Company Ids – InsideView

Use the Company Id endpoint to retrieve old company IDs associated with a single company or a list of given companyId or companyIds.

Endpoint

POST: https://api.insideview.com/api/v1/companyIds

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.

Responses

HTTP 200

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

Name	type	Description
companyId	Integer	Company InsideView ID
currentCompanyId	Integer	Current Company ID
mergedcompanyIds	List of Integers	Merged company IDs

Example:

{  
   "requests":[  
      {  
         "companyId":123
      },
      {  
         "companyId":781163
      },
      {  
         "companyId":987654
      }
   ]
}

application/json example

 
  
  {
  "companyIds": [
    {
      "companyId": "123",
      "currentCompanyId":"123456",
      "mergedCompanyIds": ["123", "1234","12345"] 
    }, 
   {
      "companyId": "781163",
      "currentCompanyId": "781163",
      "mergedCompanyIds": ["781162","91234","77777"]
    }
  ]
}

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 - HTTP method other than POST is not allowed.

HTTP 404

Invalid ID, record not found.

HTTP 429

Request is throttled.

Articles in this section

[POST] - Company Ids