Shareholders

The Shareholders action provides information on people and businesses who are defined as a shareholder of the business. The response will contain the name of the person or business, the share type issued, and total held as a percentage (%) All shareholders are deemed as current.

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 Shareholders action to retrieve information about people or businesses who are shareholders of the requested business.

Service Request

To request for a Deceased Register, add SHAREHOLDERS action to the request body entity BusinessesDetailsActionsRequest:

{
    "actions": [
      {
        "action": "SHAREHOLDERS"
      }
    ],
    "matchId": "B_000000000"
}

	Array of objects (PeopleDetailsAction)
matchId	string (MatchId) Identifier of a matched person, business or address that can then be used to request more details of the match.
tags	Array of strings Free text tags for tracking purposes.

{

• "actions": [

  • {

    • "action": "SUMMARY"

    }

  ],
• "matchId": "P_1955F18491918",
• "tags": [

  • "CASE_NUMBER=123",
  • "IMPORTANT"

  ]

}

A valid x-investigation-token header must be included in the request.

Service Response

The Shareholders action returns a JSON object containing information about the shareholders of the business included in BusinessesDetailsActionsResponse's shareholders property.

object (DeceasedRegister)

{

• "deceasedRegister": {

  • "firstName": "string",
  • "middleNames": [

    • "James"

    ],
  • "lastNames": [

    • "Smith"

    ],
  • "alias": "Jonny",
  • "maidenName": "Hunter",
  • "address": {

    • "premise": "128",
    • "building": "string",
    • "subBuilding": "string",
    • "thoroughfare": "Queen Victoria Street",
    • "locality": "London",
    • "postalCode": "EC4V 4BJ",
    • "country": "GBR"

    },
  • "source": "Deceased Register",
  • "dateOfBirth": {

    • "day": 31,
    • "month": 12,
    • "year": 1981

    },
  • "dateOfDeath": {

    • "day": 31,
    • "month": 12,
    • "year": 1981

    },
  • "registrationDistrict": "Birmingham",
  • "referenceNumber": "522880000",
  • "confidenceLevel": 6,
  • "placeOfBirth": "London",
  • "isProvidedDod": true

  }

}

A standard example workflow is detailed in Details Actions page