Skip to main content

Property Ownership

Property Ownership is a service that verifies whether a person is or was a registered owner of a given address. This service is crucial in validating the authenticity of a person's claim to an address.

Minimum Requirements​

To perform a Property Ownership verification, the following minimum inputs are required:

InputDescription
ForenameFirst Name of the individual
SurnameLast Name of the individual
Full PostcodeFull post code of the individual
Building NumberAnd/Or the Building Number of the individual
Building NameAnd/Or the Building Name of the individual
PremiseIf it exists alongside building name or number

Service Request​

To request a Property Ownership verification, include a PROPERTY_OWNERSHIP action in the request body entity PeopleActionsRequest. Here is an example snippet of the action:

{
  "actions": [
    {
      "action": "PROPERTY_OWNERSHIP"
    }
  ]
}

PeopleActionsRequest​

Array of objects (PersonAction)

Actions to run with the given criteria

object (PersonRequest)

Person format used across the Investigate API

object (Address)

Address format used across the Investigate API

cohabitants
Array of strings (Cohabitants)

Cohabitants at given address

sourceYears
Array of integers <int32> (SourceYears) [ items <int32 > ]

Years when the matching datasets stored by GBG were issued. This could support customers compliance requirements.

tags
Array of strings

Free text tags for tracking purposes.

{
  • "actions": [
    ],
  • "person": {
    },
  • "address": {
    },
  • "cohabitants": [
    ],
  • "sourceYears": [
    ],
  • "tags": [
    ]
}

Service Response​

The results of the Property Ownership verification are included in the propertyOwnership property of the PersonActionsResponse entity.

PropertyOwnershipActionResponse​

object (PropertyOwnership)
object (Meta)

Metadata describing the response produced.

{
  • "ownership": {
    },
  • "meta": {
    }
}