Android

Requirements

minSdk 26 (Android 8.0)
JDK 17
Jetpack Compose in the host app
A physical device for capture steps

1. Get access to the packages

Artifacts are published to GitHub Packages. Ask your Legal Talent contact to add your GitHub users to the partner team, then create a classic personal access token with read:packages and repo (read). Store the credentials in ~/.gradle/gradle.properties, never in the project:

gpr.user=YOUR_GITHUB_USERNAME
gpr.token=ghp_...

GitHub Packages requires authentication even for public packages. On CI, inject gpr.user / gpr.token as Gradle properties from your secrets store.

2. Add the dependency

settings.gradle.kts

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://maven.pkg.github.com/legal-talent/legaltalent-android")
            credentials {
                username = providers.gradleProperty("gpr.user").get()
                password = providers.gradleProperty("gpr.token").get()
            }
        }
    }
}

app/build.gradle.kts

dependencies {
    implementation("ai.legaltalent.sdk:legaltalent-ui:0.1.0")
}

legaltalent-ui brings in core, forensics and liveness. Use legaltalent-core alone for a headless integration.

3. Permissions and network

The SDK’s manifest already declares CAMERA (and NFC in the NFC module); the SDK requests the runtime permission when a capture step opens. You don’t need to add anything. Keep HTTPS only. Recommended res/xml/network_security_config.xml:

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="false">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>

4. Create a session on your backend

Your backend creates the session with its API key and returns only the access_token to the app:

curl -X POST https://kyc.legaltalent.ai/kyc/sessions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "YOUR_WORKFLOW_ID",
    "client_id": "your-internal-user-id"
  }'

Return data.access_token to the app. See Create Session for every parameter.

Never call POST /kyc/sessions from the app, and never embed the API key in the APK.

5. Present the flow

import ai.legaltalent.sdk.core.KYCEnvironment
import ai.legaltalent.sdk.ui.LegalTalentFlowView

@Composable
fun OnboardingScreen(accessToken: String, onDone: () -> Unit) {
    LegalTalentFlowView(
        accessToken = accessToken,
        environment = KYCEnvironment.PRODUCTION,
        onComplete = { session ->
            // The applicant finished. The decision arrives on your backend.
            onDone()
        },
    )
}

environment defaults to KYCEnvironment.DEV. Always pass it explicitly: STAGING while you integrate, PRODUCTION when you go live. The token must come from the same environment.

The flow state lives in a ViewModel keyed by the access token, so it survives configuration changes such as rotation.

6. Handle the result

onComplete fires once, after the last step is submitted. Treat it as a UX signal:

Navigate away from the flow and show a “verification in progress” screen.
Wait for your backend to receive kyc.session.processed (or the manual approved / rejected events), or poll GET /kyc/sessions/{id} from your backend.
Update the app from your backend’s state.

Android does not have an onExit callback yet. The applicant leaves the flow with the system back gesture, handled by your navigation. The session stays open until it expires, so presenting the flow again with the same token resumes where they left off.

Headless

import ai.legaltalent.sdk.core.KYCEnvironment
import ai.legaltalent.sdk.core.LegalTalentClient

val client = LegalTalentClient(accessToken = token, environment = KYCEnvironment.PRODUCTION)
val session = client.getSession()
val workflow = client.getWorkflow()

Errors are thrown as LegalTalentError; see Reference.

Getting Started

Guides

Mobile SDK

Claude Connector

Legal

Requirements

1. Get access to the packages

2. Add the dependency

3. Permissions and network

4. Create a session on your backend

5. Present the flow

6. Handle the result

Headless

​Requirements

​1. Get access to the packages

​2. Add the dependency

​3. Permissions and network

​4. Create a session on your backend

​5. Present the flow

​6. Handle the result

​Headless

Requirements

1. Get access to the packages

2. Add the dependency

3. Permissions and network

4. Create a session on your backend

5. Present the flow

6. Handle the result

Headless