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

# requestAuthorization(forPhoneNumber:completion:)

Presents a prompt that asks the person to allow cellular plan checks for their phone number.

```
class func requestAuthorization(forPhoneNumber phoneNumber: String, completion completionHandler: @escaping @Sendable (CTCellularPlanStatusAuthorization, (any Error)?) -> Void)
```

```
class func requestAuthorization(forPhoneNumber phoneNumber: String) async throws -> CTCellularPlanStatusAuthorization
```

## 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 authorization result and any error that occurs.

## Discussion

The completion handler receives a [`CTCellularPlanStatusAuthorization`](/documentation/CoreTelephony/CTCellularPlanStatusAuthorization) value in the following circumstances:

- [`CTCellularPlanStatusAuthorization.authorized`](/documentation/CoreTelephony/CTCellularPlanStatusAuthorization/authorized): The person grants permission.
- [`CTCellularPlanStatusAuthorization.notAuthorized`](/documentation/CoreTelephony/CTCellularPlanStatusAuthorization/notAuthorized): The person denies permission.
- [`CTCellularPlanStatusAuthorization.restricted`](/documentation/CoreTelephony/CTCellularPlanStatusAuthorization/restricted): Cellular plan checks aren’t available for the given number.

Only call [`getHintForPhoneNumber(_:completion:)`](/documentation/CoreTelephony/CTCellularPlanStatus/getHintForPhoneNumber(_:completion:)) after receiving an [`CTCellularPlanStatusAuthorization.authorized`](/documentation/CoreTelephony/CTCellularPlanStatusAuthorization/authorized) result.

---

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)