Skip to content
On this page

W2 Data Age Verification 007 Service

About the service

W2DataAgeVerification007Service is an age verification service for the United Kingdom. It provides a date of birth check against an age threshold, using various public data sources to verify that the age is either above or below the given age threshold.

Product Code: W2-DATA-AGE_VERIFICATION-007

Does this service leave a credit search Footprint? No

Request

The following properties pertain to this service.

PropertyTypeLengthOptional/MandatoryNotes
ForenameString15Mandatory
MiddleNameString15Optional
SurnameString15Mandatory
DayOfBirthInteger2Mandatory
MonthOfBirthInteger2Mandatory
YearOfBirthInteger4Mandatory
HouseNameString26Mandatory if no HouseNumber given
HouseNumberString26Mandatory if no HouseName given
PostcodeString8Mandatory
StreetString40Optional
CountyString20Optional
CityString20Optional
CountryString3OptionalIf set, must be a valid three-letter ISO country code as described here. If not set, the search will be within the United Kingdom (GBR)
AgeVerificationThresholdInteger3MandatoryThe age limit that the searched-for individual will be checked against. This will probably be something like 18, 16, 25 etc
AgeVerificationPassIfInteger3MandatoryA number between 1 and 4 that tells us what check needs to be made against the limit. The options are: 1: GreaterThan2: GreaterThanOrEqualTo3: LessThan4: LessThanOrEqualToFor example, to check that an individual is 18 or over, the AgeVerificationThreshold should be 18 and the AgeVerificationPassIf should be 2 (GreaterThanOrEqualTo).

Response

Example Response:

The following is an example service response:

json
"w2DataAgeVerification007Result": {
	"ageVerificationThreshold": 25,
	"passIf": "LessThan",
	"thresholdMet": true,
	"verifiedDob": true
}

Response breakdown

Each of the properties describes the following:

Property NameTypeDescription
VerifiedDobBoolConfirms whether or not the requested DOB has been successfully matched to the searched individual.
ThresholdMetBoolTRUE if the individual has passed the requested test. For example, if the requested age threshold was 18 and the test was GreaterThanOrEqualTo, and the service has confirmed that the individual is indeed 18 or over, this will be TRUE.If the test has failed then this value will be FALSE. Additionally, if the date of birth was not verified in the first place then this will also be a FALSE
PassIfStringThe requested test, in plain English.
AgeVerificationThresholdIntThe requested age limit
MessageStringFurther details on result, if necessary. This is mostly used for reporting errors.

Result Interpretation

In the service transaction information block (ServiceResponse > ProcessRequestResult > TransactionInformation > ServiceTransactions) the ServiceInterpretResult value will be "Pass" if the threshold was met, and "Fail" if it wasn't.

In the event of an unexpected error, the value will be "NotPerformed" and more information can be found in either the ServiceTransactionResultMessage field of the same block, or the Message block of the service result.

Sandbox

Example Sandbox Request

To use sandbox the following example request can be used.

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

json
{
    "Bundle": "KYC_UK_AGE_VERIFY",
    "Data": {
        "Forename": "Charlotte",
        "Surname": "Hurst",
        "HouseNumber": "47",
        "DayOfBirth": 12,
        "MonthOfBirth": 5,
        "YearOfBirth": 2009,
        "Street": "Bootham Terrace",
        "Postcode": "KW14 3ZB"
    },
    "Options": {
        "Sandbox": "true"
    },
    "ClientReference": "your-client-reference"
}

Sandbox cases

"Forever Young" Sandbox Cases

These sandbox cases have ages that will never change. All of their birthdays are on May 12th and their year of birth is whatever it takes to make their current age the one displayed in the "Age" column.

To use one of these sandbox cases, the requested DayOfBirth must be "12", the MonthOfBirth must be "5", and the year of birth must be whatever it takes to make them the age specified in the "Age" column on todays date.

ForenameSurnameHouseNumberStreetPostcodeFlatAge
CharlotteHurst47Bootham TerraceKW14 3ZB12
AvaPerkins53Russell RdDE55 8YN15
JonathanNorton94Dover RoadZE2 1UE816
HarrisonHumphreys77Horsefair GreenCV32 0GD17
BaileyDale37Princes StreetTN17 7ND18
MatildaKnowles80Thirsk RoadG84 3FZ219
LiamHenderson81Fulford RoadSA20 2DR20
RhysChapman17Colorado WayTW10 7ZH21
AdamDavidson29North PromenadeFK14 2WX22
AidanWaters22Thames StreetTD9 0WX25
VictoriaBishop85Baldock StreetIV1 3HG2528
NicholasGilbert65Gordon TerraceTS9 1DX50

"Fixed Age" Sandbox Cases

These sandbox cases have fixed DOBs and will "age" over time. To use these sandbox cases, simply enter the query data as listed in the table.

ForenameSurnameHouseNumberStreetPostcodeFlatDay/Month/Year OfBirth
SamanthaCole56Wressle RoadNN29 4PQ30/3/2011
FreddieTurnbull15Hudson StPH15 8ES2/7/2009
AbbieMay86Warner CloseLA14 6SD1/9/2008
BradleyFox65Walwyn RdSP7 2QD317/9/2008
KieranHart98Town LaneLN11 6RU7/3/2007
MaddisonPalmer92Dunmow RoadS72 5AH10/6/2005
DaisyMcLean56Brynglas RoadGL1 3JL12/4/2005
RachelAli38Guild StreetSE2 8YX22/11/2003
RachelGriffiths30Cheriton RdWR14 6JZ58/4/2003
ArchieLawrence26Glenurquhart RoadAB45 2QP1/11/2001
RachelRose37Ash LaneNR19 8TS28/3/2001
EvanBarlow53Scrimshire LaneSY5 3YQ6/4/2000
LouiseConway19Jesmond RdEX13 6EQ24/12/1998
JosephPower56Haslemere RoadTD13 0UW14/5/1998
LaurenLowe58Bootham TerraceIV25 5YR19/1/1997
AidanWalton74George StreetDD5 6GZ16/9/1995
NatashaPritchard87Ponteland RdPA6 0TH16/4/1995
LydiaHart50Castledore RoadB60 4PF5/11/1993
MatthewDodd64Hexham RoadIV40 5LA20/8/1992
IsobelBirch36Ramsgate RdNE47 7HH918/3/1992
LoganKemp93Wartnaby RoadPA31 6YD17/7/1990
JodieMellor4Neville StreetL36 7GR5/2/1990
LaraBaxter*68Marcham RoadYO6 8AS12/5/1990
  • Lara Baxter will always return an error with the message "A service error occurred", and is intended for testing error scenarios.