Skip to main content

Insolvency

The Insolvency action provides information about individuals who are insolvent, including their name, insolvency type, date of insolvency, and other details that may be available.

This action can be used to retrieve information about individuals who have filed for insolvency by providing their person MatchId and a valid x-investigation-token.

To use this action, you first need to make a Person Match request to retrieve an InvestigationToken and a MatchId for the individual you are interested in. Individuals who have filed for insolvency will have one of their addresses marked with a positive hasInsolvencyRecord. You can then use this person MatchId and x-investigation-token to make additional requests to the Insolvency action to retrieve information about their insolvency filings.

Service Request​

To request for an Insolvency, add INSOLVENCY action to the request body entity PeopleDetailsActionsRequest:

{
"actions": [
{
"action": "INSOLVENCY"
}
],
"matchId": "P_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": [
    ],
  • "matchId": "P_1955F18491918",
  • "tags": [
    ]
}

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

Service Response​

The Insolvency action returns a JSON object containing information about the individual's insolvency included in PeopleDetailsActionsResponse's insolvency property.

object (Insolvency)
{
  • "insolvency": {
    }
}
A standard example workflow is detailed in Details Actions page​