Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Fixed broken excerpts

...

...

...

...


Info
titleAPI Versions

This documentation relates to Version 1, the current version of the greenID Business API. Version 1 became available to customers as of  for extracting verifications and as of  for creating verifications

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

This is extra text

Exceptions and Error Handling

...

If an error or exception is encountered, the HTTP response header will contain details of the error. In most cases, we will also return an error response in JSON format

...

. An example of this error response is as follows:

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

Example errors include:

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

Methods Available

getVerification

In Version 1 of the API a single RESTful endpoint is available for getting back information on a given verification. The URL to call will be something like:

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

Input Parameters

...

Output

The output from the getVerification 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.

businessVerificationReference

...

Entities

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

Entity Object (individual)

...

List of Notes

...

Entity Object (Business)

...

Address Object

...

DataSource Object

...

Document Object

...


The following errors may be returned when the API is invoked with either a 'GET' or 'POST' command. Please refer to the pages detailing the 'GET' and 'POST' functionality for additional errors specific to each function which may also be returned:

HTTP status code

errorerror messageConditions
401unauthorised"Failed to authenticate <account id> with given password

Invalid credentials provided for your account to access the API 

Note: if you do not provide any credentials, then you will receive a 401 status in the HTTP header but no JSON error response will be provided

500Internal server error"<Message from the exception">An unexpected exception occurred within the system when processing your request. The message will be dependent on the exception encountered.

Endpoints

The greenID Business API is a RESTful web service offering the following endpoints:

businessVerification 


Code Block
https://au.vixverify.com/vixbiz/api/v1/

...

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. 

...

businessVerification/<input parameters>


This 'businessVerification' endpoint is accessed using HTTP GET and POST commands which provide the following capability:

  • GET (To retrieve a business verification)

Insert excerpt
GREEN:greenID Business API: businessVerification - GET
GREEN:greenID Business API: businessVerification - GET
nopaneltrue

  • POST (To create a business verification)

Insert excerpt
GREEN:greenID Business API: businessVerification - POST
GREEN:greenID Business API: businessVerification - POST
nopaneltrue

Contents

Child pages (Children Display)

Include Page
greenID include
greenID include

Div
stylemargin-top:20px; border-top: 3px solid #ACD03A; padding-top:20px;

On this page

Table of Contents
excludeOn this page

Include Page
greenID Business A-Z
greenID Business A-Z