[POST] - Company Wrong Information Feedback API

  • Updated

Use this API to submit any inconsistency in Company information. 

Endpoint

POST https://api.insideview.com/api/v1/company/{companyId}/wrongInfo

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). 

URI Parameters

Parameter Name Type Required Description
companyId String Yes Company ID

Query Parameters

Parameter Name Type Required Description
industryCode String No1 Use this if Company Industry is wrong 
revenue String No1 Use this if Revenue is wrong 
employees String No1 Use this if Number of Employees is wrong  
address String No1 Use this if Address is wrong  
websites String No1 Use this if Company website is wrong   
other String No1 Any additional detail or field you want to report  
removeCompany String No1,2 Use this if you wish to remove Company    

1: the request should include at least one of the above parameters.

2: If you are using this parameter, you can not use any other parameters.

Responses

HTTP 200

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

Name type Description
requestId String Request Id for submitted wrong Info
companyId String InsideView Company ID
status String Status of the request
fields Array Fields reported 
fields revenue String Annual Revenue reported
fields industryCode String Industry Id reported
fields other String Other fields reported
fields employees Integer Employee count reported
fields address String address reported
fields websites String company URL reported 
fields removeCompany String Reported to remove company
createdDate String  Request submission date 

Type: application/json

Schema

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "id": "/",
  "type": "object",
  "properties": {
    "requestId": {
      "id": "requestId",
      "type": "string"
    },
    "companyId": {
      "id": "companyId",
      "type": "string"
    },
    "status": {
      "id": "status",
      "type": "string"
    },
    "fields": {
      "id": "fields",
      "type": "array",
      "items": {
        "id": "0",
        "type": "object",
        "properties": {
          "industryCode": {
            "id": "industryCode",
            "type": "string"
          },
          "revenue": {
            "id": "revenue",
            "type": "integer"
          },
          "employees": {
            "id": "employees",
            "type": "integer"
          },
          "address": {
            "id": "address",
            "type": "string"
          },
          "websites": {
            "id": "websites",
            "type": "string"
          },
          "other": {
            "id": "other",
            "type": "string"
          },
          "removeCompany": {
            "id": "removeCompany",
            "type": "string"
          }
        }
      },
      "additionalProperties": false
    },
    "createdDate": {
      "id": "createdDate",
      "type": "string"
    }
  }
}

Example

{
   "requestId": "927002",
   "companyId": "16826011",
   "status": "new",
   "fields": {
      "revenue": 12,
      "employees": 100,
      "address": "vivek street",
      "websites": "http://vivek.com",
      "other": "vivek",
      "industryCode": "1"
   },
   "createdDate": "2016-07-04T05:07:09.148-07:00"
}

Type: application/xml

Schema

<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="companyWrongInfo">
    <xs:complexType>
      <xs:sequence>
        <xs:element type="xs:int" name="companyId"/>
        <xs:element type="xs:string" name="createdDate"/>
        <xs:element name="fields">
          <xs:complexType>
            <xs:sequence>
              <xs:element type="xs:string" name="address"/>
              <xs:element type="xs:int" name="revenue"/>
              <xs:element type="xs:string" name="websites"/>
              <xs:element type="xs:int" name="employees"/>
              <xs:element type="xs:string" name="industryCode"/>
              <xs:element type="xs:string" name="other"/>
              <xs:element type="xs:string" name="removeCompany"/>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
        <xs:element type="xs:string" name="requestId"/>
        <xs:element type="xs:string" name="status"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<companyWrongInfo>
   <companyId>16826011</companyId>
   <createdDate>2016-07-04T05:07:40.264-07:00</createdDate>
   <fields>
      <address>vivek street</address>
      <revenue>12</revenue>
      <websites>http://vivek.com</websites>
      <employees>100</employees>
      <industryCode>1</industryCode>
      <other>vivek</other>
   </fields>
   <requestId>925003</requestId>
   <status>new</status>
</companyWrongInfo>

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.

 

Was this article helpful?

0 out of 0 found this helpful