[POST] - Company Ids

  • Updated

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.