Mobile Verification

Mobile verification can contain details such as whether a mobile is valid/invalid as well as information around porting and roaming.

Minimum Requirements

Input	Description
mobile	Full mobile without or without country prefix

Service Request

To request a Mobile Verification, add a MOBILE_VERIFICATION action to the request body entity PeopleActionsRequest:

{
    "actions": [
        { "action": "MOBILE_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 mobileVerification contains the results of the request.

MobileVerificationActionResponse

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

{

• "result": [

  • {

    • "mobile": "string",
    • "result": "INVALID",
    • "originalCountryName": "United Kingdom",
    • "originalNetworkName": "O2 (Telefonica UK Ltd)",
    • "ported": true,
    • "portedNetworkName": "Vodafone UK",
    • "roaming": true,
    • "roamingNetworkName": "Vodafone FR"

    }

  ],
• "meta": {

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

  }

}

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

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

		Description
mobileVerification	mobile	The mobile number supplied
	result	The response will be based on the status supplied through the Contact Verification Result.
	originalCountryName	The originating country where the mobile was registered
	originalNetworkName	The originating network provider with whom the mobile was first registered
	ported	Boolean value to derive whether the mobile has been ported True: The mobile has been ported False: The mobile has not been ported
	portedNetworkName	The network name the mobile has been ported to If the ported value is false, then this is blank.
	roaming	Boolean value to derive whether the mobile is deemed as roaming and out of the country True: The mobile has been flagged as roaming. False: The mobile has been flagged as not roaming.
	roamingNetworkName	The network name the mobile was last seen roaming If roaming value is false, then this is blank.