Overview

Use this method to retrieve phone confirmation check results.

Response explained

The response represents a singleton list of checks.

Root variables
phoneConfirmationCheckInfo
Phone risk labels
Response example

Root variables

The root variables are the core check result data items. Some of them may include nested attributes and element fields.

Field	Type	Description
`answer`	String	Check answer: `RED` — at least one of the checks returned a high risk indication. `YELLOW` — all the checks ended up with no certain data found. `GREEN` — at least one of the checks ended up green with no high risk indication; some YELLOW results are acceptable.
`checkType`	String	Indicates this is the `PHONE_CONFIRMATION` check type.
`createdAt`	Date	Date and time (UTC) of the latest phone confirmation check result.
`id`	String	Unique identifier of the check.
`phoneConfirmationCheckInfo`	Object	Includes specific phone check parameters with check results.

`phoneConfirmationCheckInfo` attributes

The following table explains the phoneConfirmationCheckInfo attributes that represent the check results of the provided phone number in accordance with specific parameters.

Field	Type	Description
`firstSeenAt`	Date	Date and time the phone number was first used somewhere to identify its owner. For example, as a login on a web site.
`confirmedViaOtp`	String	Indicates if the phone number is confirmed by the applicant via OTP (One Time Password). `GREEN` means that the applicant received a confirmation code on the phone and confirmed it via SDK, `null` if not.
`blacklisted`	String	Indicates whether the provided phone number is included in the known global blocklists. `GREEN` — not found in blocklists. `YELLOW` — no certain data found. `RED` — found in blocklists.
`riskLevel`	String	Indicates a verdict made by the system according to the check results and internal logic. `GREEN` — no risk. `YELLOW` — medium risk. `RED` — high risk.
`nonDisposable`	String	Indicates whether the provided phone number is a disposable one and might disappear once used. `GREEN` — permanent phone number. `YELLOW` — not enough data found. `RED` — disposable phone number.
`webRegistrationsExist`	String	Indicates if the phone number is used for registration on websites. `GREEN` — phone number is used for registrations. `YELLOW` — no certain data found. `RED` — phone number was never used for registration.
`active`	String	Indicates if the phone number is acquired, activated by a user, and ready to receive calls. `GREEN` — phone number is active. `YELLOW` — no certain data found. `RED` — phone number is inactive.
`valid`	String	Indicates if the phone number exists and is valid. `GREEN` — phone number is valid. `YELLOW` — no certain data found. `RED` — phone number is invalid.
`nonVirtual`	String	Indicates if the phone number is virtual — linked to an online account with a provider, as opposed to a specific location. `GREEN` — a standard and non-virtual phone number. `YELLOW` — no certain data found. `RED` — phone number is virtual.
`phone`	String	Phone number.
`profiles`	Array of strings	Information on profiles created for social networks, services, and other platforms using the provided phone number.
`riskLabels`	Array of strings	A list of phone risk labels assigned by the system according to the check results and internal logic.

Available phone risk labels

The following table explains possible phone risk labels assigned in accordance with the check results.

Risk label	Description
`mediumRisk`	Medium-risk phone number. A verdict made by the system according to the check results and internal logic.
`highRisk`	High-risk phone number. A verdict made by the system according to the check results and internal logic.
`virtual`	Virtual phone that allows a user to make calls through the internet and is not associated with a physical location.
`noWebRegistrations`	Phone number registration on websites is not detected.
`disposable`	Disposable phone number that usually disappears once used.

Response example