> For the complete documentation index, see [llms.txt](https://carrier-sdk-docs-android.dentwireless.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://carrier-sdk-docs-android.dentwireless.com/install-profile.md).

# Install Profile

### Device Information

You must set the device information including the "**identifier**“ for the Straic Backoffice. The "**userId**" is an optional string that can be used for assigning the profile to a user. The "**userToken**" is an optional string that can be used to verify the user. It is automatically forwarded to the provided [webhook](https://docs.straic.io/) URL. The "**metadata**" is an optional `Map<String:String>` and can be used for information e.g.: Details for your server, ...

> This information is needed to assign your device eSIM profiles or to provide eSIM profiles for installation.

```kotlin
import io.straic.sdk.model.StraicSDKDeviceInformation

val identifier = "Your device identifier"
val userId = "User ID"
val userToken = "User Token"
val metadata = mapOf()

val deviceInformation = StraicSDKDeviceInformation(identifier = identifier, 
                                                    userId = userId,
                                                    userToken = userToken,
                                                    metadata = metadata)

```

The `installEsimProfileByIccid` function **with ICCID (Integrated Circuit Card Identifier)** can be used to return a specific eSIM profile for the given iccid and the success state, or an error.

```kotlin
val iccid = "Integrated Circuit Card Identifier"

StraicSDK.installEsimProfileByIccid(iccid = iccid, 
                             deviceInformation = deviceInformation,
                             resolutionActivity = this) { profile, success, error ->
    Log.i( "StraicSDK", "Profile: $profile")
    Log.i( "StraicSDK", "Success: $success")
    Log.i( "StraicSDK", "Error: $error")     
}
```

The `installEsimProfileByProfileType` function **with eSIM profile type** can be used to return the success state and the next available eSIM profile for the given profile type or an error.

```kotlin
val profileType = "eSIM Profile type"

StraicSDK.installEsimProfileByProfileType(profileType = profileType, 
                             deviceInformation = deviceInformation,
                             resolutionActivity = this) { profile, success, error ->
    Log.i( "StraicSDK", "Profile: $profile")
    Log.i( "StraicSDK", "Success: $success")
    Log.i( "StraicSDK", "Error: $error")     
}
```

\
The device operating system will show up as an installation wizard for the user for all install functions.