<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreTelephony",
  "identifier" : "/documentation/CoreTelephony/CTCellularPlanStatus/getHintForPhoneNumber(_:completion:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "Core Telephony"
    ],
    "preciseIdentifier" : "c:objc(cs)CTCellularPlanStatus(cm)getStatusHintForPhoneNumber:completion:"
  },
  "title" : "getHintForPhoneNumber(_:completion:)"
}
-->

# getHintForPhoneNumber(_:completion:)

Provides an estimate of the system’s confidence of the existence of an active cellular plan for the device’s phone number.

```
class func getHintForPhoneNumber(_ phoneNumber: String, completion completionHandler: @escaping @Sendable (CTCellularPlanStatusAvailability, CTCellularPlanStatusAvailabilityConfidence, (any Error)?) -> Void)
```

```
class func hint(forPhoneNumber phoneNumber: String) async throws -> (CTCellularPlanStatusAvailability, CTCellularPlanStatusAvailabilityConfidence)
```

## Parameters

`phoneNumber`

A phone number in [ITU-T E.164 international format](https://www.itu.int/rec/T-REC-E.164) (for example, `+15550001234`).

`completionHandler`

A closure the framework calls with the cellular plan availability, confidence level, and any error that occurs.

## Discussion

Upon completion, the [`CTCellularPlanStatusAvailability`](/documentation/CoreTelephony/CTCellularPlanStatusAvailability) instance in the handler indicates whether the device has a cellular plan for the given phone number and the framework’s confidence ([`CTCellularPlanStatusAvailabilityConfidence`](/documentation/CoreTelephony/CTCellularPlanStatusAvailabilityConfidence)) that the determination is true.

Only call this method after you receive an [`CTCellularPlanStatusAuthorization.authorized`](/documentation/CoreTelephony/CTCellularPlanStatusAuthorization/authorized) status from [`requestAuthorization(forPhoneNumber:completion:)`](/documentation/CoreTelephony/CTCellularPlanStatus/requestAuthorization(forPhoneNumber:completion:)) or [`getAuthorizationStatus(forPhoneNumber:completion:)`](/documentation/CoreTelephony/CTCellularPlanStatus/getAuthorizationStatus(forPhoneNumber:completion:)).

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)