Authentication

HTTP basic authentication is used for accessing the endpoint. The username is your greenID customer account ID that you use for greenID Business, and the password is your greenID web services password for that account. 

<<KS: Is the above sufficient for a developer to know how to use this?>>

Exceptions and Error Handling

We return an error response in JSON format if an exception occurs. An example of this is as follows:

{
  "error": "Not found",
  "message": "No verification with ID: 1775",
  "status": 404
}

Example errors include:

<<KS: I think we need to include details of what is validated and the status/error codes returned for each? Check std API docs>>

• Not Found (404)
• Unauthorized (401)
• Internal Server Error (500)

Methods Available

The following webservice methods are available for the greenID Business API version 1:

get BusinessVerification: <<KS - make this a link to the new page for this. Text below can be an 'excerpt' and use 'excerpt include' here?>>

The greenID Business API ‘get Business Verification’ method allows customers to extract the current details of a business verification. Given a greenID Business reference number, the API call returns information about the top-level business, sub-businesses, and all associated individuals (including their verification status).

Additional methods will be made available in future, for example a method to create a new business verification via the API.

get BusinessVerification. <<KS - I think this needs to be split out to a new page?>>

<<KS: Add this text as an 'excerpt on the new page'>>

The greenID Business API ‘get Business Verification’ method allows you to extract the current details of a business verification, including it's verification status. Given a greenID Business reference number, the API call returns information about the business to be verified (i.e. the 'top level' or 'root business'), it's sub-businesses (for example shareholder businesses), and all associated individuals (including their verification status).

The 'get BusinessVerification' method is available as a RESTful endpoint. The URL to call is as follows:

<<KS: Do we need to specify something in the above text about using 'get' in conjunction with the below url?? Jo to advise... >> 

http://au.vixverify.com/vixbiz/api/v1/businessVerification/<verification_reference_id>

Input Parameters

Output

The output from the get BusinessVerification call will be in JSON format, and contains four main sections:

1. businessVerificationReference
2. Entities
3. Relationships
4. rootBusiness

An entity could be an individual or business, and relationships are the connections between different entities. Each of these will have a unique ID.

<<KS: Describe rootBusiness. Should it be listed first? Think maybe we need a bit more info in this section to describe each section?>>

businessVerificationReference

Entities

The following section gives details on the fields in each entity structure.

Entity Object (individual)

Entity Object (Business)

Address Object

DataSource Object

Document Object

Note Object

Verification Object

Relationships

The following section gives details on the fields in each relationship structure.

Relationship Object

Field Object

rootBusiness Object

This object gives details on the root business that was originally searched for.