Mortality UK 035

Check to determine if a person is deceased

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Compatible Cases

Icon 1

About the service

W2 Data Mortality UK 035 is a UK identity verification service that checks data against a variety of different sources to determine if the person is deceased. If there are multiple matches, it provides a list of them, up to a limit of 10.

Product Code: W2-DATA-MORTALITY-UK-035

Does this service leave a credit search Footprint? No


Request

The following properties pertain to this service, please note that the fields MUST be in the same order as shown below.


Example request

"Data": {
    "DayOfBirth": 16,
    "Forename": "Brandon",
    "HouseName": "1 HANOVER GRANGE",
    "MonthOfBirth": 11,
    "Postcode": "YO167BX",
    "Surname": "Truman",
    "YearOfBirth": 1945
  }

Response

Example response

"W2DataMortalityUk035Result" : {
    "MortalityResult" : {
        "MortalityResponse"
            "MatchData" : {
                "AddressMatch" : "true",
                "DobMatch" : "true",
                "NameMatch" : "true",
                "PostcodeMatch" : "true"
            },
            "Person" : {
                "Address1" : "1 HANOVER GRANGE",
                "Address2" : "BRIDLINGTON",
                "Address3" : "EAST RIDING OF YORKSHIRE",
                "Address4" : "Y016 7BX",
                "Address5" : "",
                "DateOfBirth" : "1945-11-1600:00:00",
                "DateOfDeath" : "2019-09-1900:00:00",
                "Forename" : "BRANDON",
                "MiddleName" : "LEWIS",
                "Postcode" : "Y0167BX",
                "Score" : "9",
                "Surname" : "TRUMAN",
                "Title" : "MR",
                "UniqueReferenceNumber" : "06186191"
            } 
        }
    }
}

Transaction Result

After performing the search, the TransactionInformation will be part of the ProcessRequestParameters returned for the service call.

The following shows the basic schema for the TransactionInformation object that is returned in the ProcessRequestResult object.

PropertyValue
FailoverOverToDid the service encounter a third party error, and fail over to an alternate service? (Not applicable for this service).
HaltTriggeredWas there a halt condition included in the bundle that has been triggered?
ServiceInterpretResultOneResult, MultipleResults, NoResults, NotPerformed - An error occurred and the search was not performed
ServiceTransactionResultSuccess, SuccessNoResults, SuccessIncompleteResults - Too many matches generated, results truncated, ClientErrorInsufficientInformation - Required field not supplied, ClientErrorInformationFormatInvalid - Invalid format in field, ServerErrorGeneralError - Error with third party service
ServiceTransactionResultMessageOne Potential Match Found, Multiple Potential Matches Found, No Potential Matches Found
ServiceValidationDetailsShows the messages related to a validation error if applicable.
ValidationResultNotApplicable - No search occurred to match against, Fail - MissingMandatoryField or PatternNotMatched

Sandbox

To use sandbox the following example request can be used.

Remember to include the W2-provided API key in the Authorization Header.

Example request

{
    "Bundle": "W2-DATA-MORTALITY-UK-035",
    "Data": {
      "DayOfBirth": 11,
      "Forename": "Alex",
      "HouseNumber": "81",
      "MonthOfBirth": 3,
      "Postcode": "PA33 7WB",
      "Street": "Crescent Avenue",
      "Surname": "Goodwin",
      "YearOfBirth": 1941
    },
    "Options": {
        "Sandbox": "true"
    },
    "ClientReference": "your-client-reference"
}

Query Params
string
enum
required
Defaults to 1.5

API version to use

Allowed:
Body Params
string
required

The bundle of services to call

string

A unique reference for the call

Data
object
required
Options
object

These are optional parameters for some extra fields not covered in the Data object. Use this section to set Sandbox mode as well as to add search filters on alerts.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json