Share via


Call.Details.CallerNumberVerificationStatus Property

Definition

Gets the verification status for the phone number of an incoming call as identified in ATIS-1000082.

public virtual int CallerNumberVerificationStatus { [Android.Runtime.Register("getCallerNumberVerificationStatus", "()I", "GetGetCallerNumberVerificationStatusHandler", ApiSince=30)] get; }
[<get: Android.Runtime.Register("getCallerNumberVerificationStatus", "()I", "GetGetCallerNumberVerificationStatusHandler", ApiSince=30)>]
member this.CallerNumberVerificationStatus : int

Property Value

the verification status.

Attributes

Remarks

Gets the verification status for the phone number of an incoming call as identified in ATIS-1000082.

For incoming calls, the number verification status indicates whether the device was able to verify the authenticity of the calling number using the STIR process outlined in ATIS-1000082. Connection#VERIFICATION_STATUS_NOT_VERIFIED indicates that the network was not able to use STIR to verify the caller's number (i.e. nothing is known regarding the authenticity of the number. Connection#VERIFICATION_STATUS_PASSED indicates that the network was able to use STIR to verify the caller's number. This indicates that the network has a high degree of confidence that the incoming call actually originated from the indicated number. Connection#VERIFICATION_STATUS_FAILED indicates that the network's STIR verification did not pass. This indicates that the incoming call may not actually be from the indicated number. This could occur if, for example, the caller is using an impersonated phone number.

A CallScreeningService can use this information to help determine if an incoming call is potentially an unwanted call. A verification status of Connection#VERIFICATION_STATUS_FAILED indicates that an incoming call may not actually be from the number indicated on the call (i.e. impersonated number) and that it should potentially be blocked. Likewise, Connection#VERIFICATION_STATUS_PASSED can be used as a positive signal to help clarify that the incoming call is originating from the indicated number and it is less likely to be an undesirable call.

An InCallService can use this information to provide a visual indicator to the user regarding the verification status of a call and to help identify calls from potentially impersonated numbers.

Java documentation for android.telecom.Call.Details.getCallerNumberVerificationStatus().

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to