Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Overview

Use this method to retrieve phone confirmation check results.

Required permissions

To use this method, your app token must have the View check results permission.

Request example

curl -X GET \
     'https://api.sumsub.com/resources/checks/latest?type=PHONE_CONFIRMATION' \
     -H 'X-App-Token: <your-app-token>' \
     -H 'X-App-Access-Sig: <your-signature>' \
     -H 'X-App-Access-Ts: <unix-timestamp>'

Response explained

The response represents a singleton list of checks.

Root variables
- phoneConfirmationCheckInfo attributes
- 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	Earliest known date for this phone number across all Sumsub data: activation, carrier change, or first activity seen. Carriers give old numbers to new owners, so this date can be earlier than the moment the applicant got the number.
`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.
`blocklisted`	Boolean	`true` if the phone number is in your blocklist in Custom lists. Otherwise the field is not returned.
`whitelisted`	Boolean	`true` if the phone number is in your allowlist in Custom lists. Otherwise the field is not returned.
`riskScore`	Integer	Sumsub risk score of the phone number, from `0` to `100`. Higher means riskier.
`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.
`intelligence`	Object	Network activity signals for the phone number.
`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.

`intelligence` attributes

The intelligence object shows how the phone number has been used, based on the Sumsub network. The Sumsub network is a telecom data network: it uses telecom signals that show the number is in live use. No subscriber identity, message content or call records are used. Your data on mobile phone users and their links to identities is not shared in the network.

We recommend using these fields as features in risk assessment and machine learning models that combine many signals, not as a single flag for making decisions.
If there is no history for the number, the field is not returned. A missing field means never observed, not zero, or low activity. The whole intelligence object may be missing.
Counts (activityCountRaw, activeDaysCount, velocity…) show how much history exists. Indexes (activityIndex, velocity…Index) show how intense the activity is.

Field	Type	Description
`firstSeenDays`	Integer	Days since the phone number was first seen in the network. This is the history of the number, not of its current owner.
`lastSeenDays`	Integer	Days since the phone number was last seen in the network.
`activityLifetimeDays`	Integer	Days between the first and the last activity.
`activeDaysCount`	Integer	Number of separate days with at least one activity. Several activities on one day count as one day. A low value means little proof that the number is really in use.
`activityCountRaw`	Integer	Total number of activities seen.
`activityIndex`	Integer	How intense the activity is compared with how long the number has been seen, from `0` to `10`. It does not show the total amount of activity.
`diversityIndex`	Integer	How widely the number is linked to different identities.
`avgReuseIntervalDays`	Integer	Average number of days between repeat appearances of the number.
`velocity1d`, `velocity7d`, `velocity30d`, `velocity90d`, `velocity360d`	Integer	Number of activities in the last 1, 7, 30, 90, and 360 days.
`velocity1dIndex`, `velocity7dIndex`, `velocity30dIndex`, `velocity90dIndex`, `velocity360dIndex`	Integer	Intensity of activity for the same time windows.
`whatsappProfileCompleteness`	String	WhatsApp profile for this number: `GREEN` — full profile. `YELLOW` — partial profile. `RED` — no profile.
`currentNetworkIsPremium`	Boolean	`true` if the mobile carrier that serves the number now is a premium carrier.
`digitalSophisticationIndex`	Integer	How active the owner is online overall, from `0` to `10`, based on the platforms where the number is registered.
`globalPlatformRatio`	Number	Share of checked global platforms where the number is registered, from `0.0` to `1.0`.
`totalPlatformCount`	Integer	Number of platforms, global and local, where the number is registered.
`messagingGlobalPlatformCount`	Integer	Number of global messaging apps where the number is registered.

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.
`blocklisted`	Phone number is in your blocklist.
`freshPhone`	Phone number was first seen recently.
`phoneCountryVsApplicantCountryMismatch`	Phone number country differs from the applicant's country.
`phoneCountryVsIpCountryMismatch`	Phone number country differs from the IP address country.
`phoneCountryVsAddressCountryMismatch`	Phone number country differs from the address country.
`phoneCountryVsEmailDomainCountryMismatch`	Phone number country differs from the email domain country.
`phoneCountryVsCompanyCountryMismatch`	Phone number country differs from the company's country.

Response example

{
  "checks": [
    {
      "answer": "GREEN",
      "checkType": "PHONE_CONFIRMATION",
      "createdAt": "2022-08-25 12:00:43",
      "id": "01735091-e1d4-4744-99ac-000000000000",
      "phoneConfirmationCheckInfo": {
        "riskScore": 35,
        "firstSeenAt": "2019-03-14 00:00:00",
        "confirmedViaOtp": "GREEN",
        "riskLevel": "YELLOW",
        "nonDisposable": "GREEN",
        "webRegistrationsExist": "GREEN",
        "active": "GREEN",
        "valid": "GREEN",
        "nonVirtual": "GREEN",
        "phone": "+15550000000",
        "profiles": [
          "whatsapp",
          "facebook",
          "instagram",
          "amazon",
          "microsoft"
        ],
        "riskLabels": [
          "mediumRisk",
          "phoneCountryVsIpCountryMismatch"
        ],
        "intelligence": {
          "firstSeenDays": 2420,
          "lastSeenDays": 2,
          "activityLifetimeDays": 2418,
          "activeDaysCount": 310,
          "activityCountRaw": 1250,
          "activityIndex": 6,
          "diversityIndex": 2,
          "avgReuseIntervalDays": 8,
          "velocity1d": 1,
          "velocity7d": 4,
          "velocity30d": 15,
          "velocity90d": 41,
          "velocity360d": 160,
          "velocity1dIndex": 3,
          "velocity7dIndex": 4,
          "velocity30dIndex": 5,
          "velocity90dIndex": 5,
          "velocity360dIndex": 6,
          "whatsappProfileCompleteness": "GREEN",
          "currentNetworkIsPremium": false,
          "digitalSophisticationIndex": 7,
          "globalPlatformRatio": 0.42,
          "totalPlatformCount": 5,
          "messagingGlobalPlatformCount": 1
        }
      }
    }
  ]
}