Landline Verification

Landline verification can contain details such as whether a landline is valid or invalid.

Minimum Requirements

Input	Description
landline	Full UK landline without country prefix

Service Request

To request a Landline Verification, add a LANDLINE_VERIFICATION action to the request body entity PeopleActionsRequest:

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

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": [

  • {

    • "action": "EMAIL_VERIFICATION"

    }

  ],
• "person": {

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

    • "James"

    ],
  • "lastNames": [

    • "Smith"

    ],
  • "dateOfBirth": {

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

    },
  • "gender": "U",
  • "phones": [

    • "+44 207 4281250"

    ],
  • "emails": [

    • "investigate@gbgplc.com"

    ],
  • "ageBand": {

    • "min": 31,
    • "max": 32

    }

  },
• "address": {

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

  },
• "cohabitants": [

  • "John",
  • "Rita M Brown",
  • "Mary Williams"

  ],
• "sourceYears": [

  • 2021,
  • 2022

  ],
• "tags": [

  • "CASE_NUMBER=123",
  • "IMPORTANT"

  ]

}

Service Response

As part of the PersonActionsResponse entity, the property landlineVerification contains the results of the request.

LandlineVerificationActionResponse

	Array of objects (LandlineVerificationAction)
	object (Meta) Metadata describing the response produced.

{

• "result": [

  • {

    • "landline": "string",
    • "result": "INVALID",
    • "status": "LIVE"

    }

  ],
• "meta": {

  • "traceId": "7ab2ff08-728a-42e6-aa38-df191ffd4817",
  • "timestamp": "2019-01-04T14:38:25Z",
  • "investigationToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0cmFjZUlkIjoiMTIzNDU2IiwibWF0Y2hJZHMiOltdLCJleHAiOjE1MTYyMzkwMjJ9.3SZoV56G0HT289QqP04OT5F1ITtsMqRCGkPok2-st50"

  }

}

If no Landline Verification has been requested, the response is empty.

If a Landline Verification has been requested, the following response is available:

Action	Parameter	Description
landlineVerification	landline	the landline number supplied
	status	based on contact verification result