--- updatedAt: 2026-09-18T09:34:17.000Z agentTools: projectIndex: https://docs.sumsub.com/llms.txt --- # Get phone confirmation check results # Overview Use this method to retrieve [phone confirmation](/docs/email-and-phone-verification) check results. ## Required permissions To use this method, your [app token](https://docs.sumsub.com/sumsub/docs/app-tokens) must have the **View check results** [permission](https://docs.sumsub.com/sumsub/docs/user-roles#permissions). # Request example ```curl curl -X GET \ 'https://api.sumsub.com/resources/checks/latest?type=PHONE_CONFIRMATION' \ -H 'X-App-Token: ' \ -H 'X-App-Access-Sig: ' \ -H 'X-App-Access-Ts: ' ``` # Response explained The response represents a singleton list of checks. * [Root variables](#root-variables) * [phoneConfirmationCheckInfo attributes](#phoneconfirmationcheckinfo-attributes) * [Phone risk labels](#available-phone-risk-labels) * [Response example](#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](#emailconfirmationcheckinfo-attributes) | 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 blocked in your Client lists.

  • GREEN — not found in blocklists.
  • YELLOW — no definitive data available.
  • 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](#available-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 ```json { "checks": [ { "answer": "GREEN", "checkType": "PHONE_CONFIRMATION", "createdAt": "2022-08-25 12:00:43", "id": "01735091-e1d4-4744-99ac-000000000000", "phoneConfirmationCheckInfo": { "firstSeenAt": null, "confirmedViaOtp": null, "blacklisted": "GREEN", "riskLevel": "YELLOW", "nonDisposable": "YELLOW", "webRegistrationsExist": "YELLOW", "active": "YELLOW", "valid": "YELLOW", "nonVirtual": "YELLOW", "phone": "+111 111 111 111", "profiles": null, "riskLabels": null } } ] } ``` # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "sumsub-api", "version": "1.0" }, "servers": [ { "url": "https://api.sumsub.com" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "name": "X-App-Token", "in": "header", "x-default": "" } } }, "security": [ { "sec0": [] } ], "paths": { "/resources/checks/latest?type=PHONE_CONFIRMATION": { "get": { "summary": "Get phone confirmation check results", "description": "", "operationId": "get-phone-confirmation-check-results", "parameters": [ { "name": "applicantId", "in": "query", "description": "Unique applicant identifier in the Sumsub system.

This identifier is a random combination of 24 digits and lowercase Latin characters. It is automatically generated when the applicant is created on the Sumsub side, and can be found in the [Dashboard](https://cockpit.sumsub.com/checkus/#/applicants/individual?limit=10&page=0).

If the `applicantId` is unknown to you, use the [Get applicant data (externalUserId)](https://docs.sumsub.com/sumsub/reference/get-applicant-data-via-externaluserid) method to fetch it.", "required": true, "schema": { "type": "string" } } ], "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```