Directors
The Directors action provides information on people and businesses who are defined as a director of the business. The response will contain the name of the person or business, the date appointed, the director type (director or secretary) and the date resigned, if it exists.
This action can be used to retrieve information about a business by providing their business MatchId and a valid x-investigation-token.
To use this action, you first need to make a Business Match request to retrieve an InvestigationToken and a MatchId for the business you are interested in.
You can then use this business MatchId and x-investigation-token to make additional requests to the Directors action to retrieve information about people or businesses who are or were directors of the requested business.
Service Request​
To request for a Deceased Register, add DIRECTORS action to the request body entity BusinessesDetailsActionsRequest:
{
"actions": [
{
"action": "DIRECTORS"
}
],
"matchId": "B_000000000"
}
A valid x-investigation-token header must be included in the request.
Service Response​
The Directors action returns a JSON object containing information about the directors of the business included in BusinessesDetailsActionsResponse's directors property.