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 |
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "/",
"type": "array",
"items": {
"id": "0",
"type": "object",
"properties": {
"mergedCompanyIds": {
"id": "mergedCompanyIds",
"type": "array",
"items": {
"id": "0",
"type": "integer"
},
"uniqueItems": true
},
"companyId": {
"id": "companyId",
"type": "integer"
},
"currentCompanyId": {
"id": "currentCompanyId",
"type": "integer"
}
}
}
}
Example
[
{
"currentCompanyId": 13457,
"mergedCompanyIds": [
1755
],
"companyId": 1755
},
{
"companyId": 726263
}
]
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="companyDTOes" type = "companyDTOes"/> <xs:complexType name="companyDTOes"> <xs:sequence> <xs:element name="company" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="mergedCompanyIds" minOccurs="0"> <xs:complexType> <xs:sequence> <xs:element name="mergedCompanyId" type="xs:integer" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="companyId" type="xs:int" minOccurs="0"/> <xs:element name="currentCompanyId" type="xs:int" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:schema>
Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <companyDTOes> <company> <companyId>1755</companyId> <currentCompanyId>13457</currentCompanyId> <mergedCompanyIds> <mergedCompanyId>1755</mergedCompanyId> </mergedCompanyIds> </company> <company> <companyId>726263</companyId> </company> </companyDTOes>
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.