Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


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 

Authentication

Details on authentication.

...

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

Entities

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

...

Entity

...

Object

Field NameDescriptionTypeExample
addressA structure encoding the address of the entity Address-
childrenThe children of an entity.

dataSourceDetails on the data source (e.g. a company register) used for getting information on a "business" entity.DataSource-
entityTypeThe type of the entityString"business" or "individual"
fromDataSourceWhether or not this entity came from a data source (e.g. a lookup of a company register).Boolean"true" or "false"
idThe ID of this entityInteger789112
notesA list of notes associated with this entityNote-
verificationA structure encoding verification details for the entityVerification-

...

Field NameDescriptionTypeExample
dateDueThe due date for this verificationString2018-08-08 00:00:09.217+0000
dateNominatedThe date that this verification was nominated (created)String2018-08-07 23:16:47.065+0000
idThe ID of this verification structureInteger810290
statusThe status of this verificationString"Not yet verified", "verified" etc.

Relationships

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

Relationship Object

Field NameDescriptionTypeExample
activeRelatedEntityThe ID of the active related entity in this relationshipInteger