<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppClip",
  "identifier" : "/documentation/AppClip/APActivationPayload/confirmAcquired(in:completionHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "App Clips"
    ],
    "preciseIdentifier" : "c:objc(cs)APActivationPayload(im)confirmAcquiredInRegion:completionHandler:"
  },
  "title" : "confirmAcquired(in:completionHandler:)"
}
-->

# confirmAcquired(in:completionHandler:)

Checks whether an App Clip invocation happened at an expected physical location.

```
func confirmAcquired(in region: CLRegion, completionHandler: @escaping @Sendable (Bool, (any Error)?) -> Void)
```

```
func confirmAcquired(in region: CLRegion) async throws -> Bool
```

## Parameters

`region`

The expected physical location at the time of the App Clip invocation.

`completionHandler`

A closure called when the platform confirms the expected physical location at the time of the App Clip invocation.

    The closure takes the following parameters:

- inRegion: A Boolean value that indicates whether the App Clip invocation happened at the expected physical location.
- error: The error object that describes why the platform couldn’t confirm the user’s physical location.

    This parameter is     `nil`     if the platform was able to determine the user’s physical location at the time of the App Clip invocation.

## Discussion

> Important:
> You can call this method from synchronous code using a completion handler, as shown on this page, or you can call it as an asynchronous method that has the following declaration:
> 
> ```swift
> func confirmAcquired(in region: CLRegion) async throws -> Bool
> ```
> 
> For information about concurrency and asynchronous code in Swift, see <doc://com.apple.documentation/documentation/Swift/calling-objective-c-apis-asynchronously>.

Confirm the user’s location at the time of the App Clip invocation if the App Clip is associated with a physical location. The request to confirm the location fails with [`disallowed`](/documentation/AppClip/APActivationPayloadError/disallowed) if the source of the invocation isn’t an NFC tag or visual code.

For the platform to accept the request to confirm the user’s location, you need to make modifications to the `Info.plist` file of the App Clip. For more information, see [Enabling notifications in App Clips](/documentation/AppClip/enabling-notifications-in-app-clips).

> Note:
> Functionality to confirm the user’s location is only available to App Clips. For the full app, request permission to access the user’s location and make use of the <doc://com.apple.documentation/documentation/CoreLocation> framework. For more information, see <doc://com.apple.documentation/documentation/CoreLocation/getting-the-current-location-of-a-device>.

---

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)