Address Verify

SDKs live · v1.0.1

Proof of
address.
Without the
paperwork.

Address Verify uses overnight GPS tracking to confirm where someone actually lives, for compliance, KYC, or any use case that requires proof of residence. No utility bills. No field visits. You set the verification window.

iOSAndroidReact NativeOvernight GPS
TrackingNight 0 / 14

The problem

Traditional address verification doesn't work in Africa.

Utility bills, postal codes, property registries: the methods built for Western markets are unreliable or absent across much of Africa. Field visits are expensive and slow. People give false addresses, and there's no easy way to check.

Address Verify uses the device the person already carries, their phone, to observe where it sleeps at night. If it's consistently at the claimed address, that's evidence of residence. Simple, passive, scalable. And you control how long the window runs.

How it works

Four steps.
One verdict.

01

Integrate the SDK

Add the Lira SDK to your app (React Native, Android, or iOS). One dependency. No backend plumbing required.

02

Call launchSetup()

The SDK presents a native UI: the user confirms their address on a map and grants background location. You set the verification window. The SDK creates the job and returns a jobId.

03

SDK tracks overnight

Passively collects GPS fixes during the nightly window you define. The user just needs their phone at home. No action required.

04

Receive a verdict

Once the window closes, poll the API or receive a webhook. You get a confidence score and a verdict: High, Moderate, Low, or Inconclusive.

SDK · launchSetupVerdict · your window

React Native

import { launchSetup } from '@uselira/react-native'

const result = await launchSetup({
  apiKey: 'lira_live_a3f08c1d...',
  customerRef: 'KYC-2026-0042',
  duration: 7,
  scheduleStart: '20:00',
  scheduleEnd: '06:00'
});

// result.jobId - store on your server

Final verdict

{
  "status": "complete",
  "verdict": "high",
  "confidence_score": 87,
  "nights_observed": 7,
  "nights_at_home": 6,
  "avg_hours_at_home": 7.2
}
api.lira.com/api/v1 · REST · HTTPSFull API reference →

Available SDKs

v1.0.1 across all platforms

Install in
one line.

The Address Verify SDK ships natively for iOS and Android, with a React Native binding that wraps both. Pick the install command for your stack and you are ready to call launchSetup().

Read the integration guide
Swift 5.9 · iOS 16+

iOS

CocoaPods
pod 'UseliraCore', '~> 1.0'
Swift Package Manager
https://github.com/Lira-api/lira-ios-dist
Kotlin 1.9+ · API 26 (Android 8.0)

Android

Maven Central
implementation "com.uselira.sdk:core:1.0.1"
React Native 0.71+

React Native

Yarn
yarn add @uselira/core
npm
npm install @uselira/core

The verdict

A clear answer.
Every time.

High≥ 75

Strong evidence the person lives at the claimed address. Consistent overnight presence across multiple nights.

Moderate≥ 50

Some evidence of residence. Patterns are present but inconsistent. Consider additional checks.

Low< 50

Little evidence of residence at this address. The device was rarely or never detected overnight.

Inconclusive< 3 nights

Not enough data to reach a verdict. The tracking period ended without sufficient overnight observations.

Privacy & consent

Built on consent.
Backed by deletion.

Address Verify only works because people trust it. We collect what we need to confirm residence and nothing more. Users see what is being collected, agree before any data flows, and can ask for it back at any time.

Consent

Always opted in.

Users grant location access through a clear native permission prompt. No background tracking without their explicit knowledge.

Scope

Address only.

Lira does not collect phone numbers, contacts, app usage, or any other personal information about the person being verified.

Retention

Three months, then gone.

Location data is deleted on request and automatically after 90 days. No long-term storage of where people live.

Frequently asked

What teams
ask first.

How does Lira verify a residential address?

The SDK collects passive GPS samples during a nightly window you configure. After the verification window closes, Lira scores how consistently the device slept at the claimed location and returns a verdict.

What does the customer have to do?

Install your app, tap the consent screen the SDK presents, and grant background location once. That is the entire interaction. No paperwork, no field visits, no follow-up.

How long does verification take?

Most jobs run for 14 nights by default. You can configure the window anywhere from 3 to 90 nights depending on your risk policy and compliance requirements.

Is it GDPR and POPIA compliant?

Consent is recorded per job with a timestamp and policy version. Customers can revoke at any time via the cancel API, and all location data is deleted automatically after 90 days.

Which countries are supported?

Address Verify works in any market where GPS works. Lira is actively piloting in Zambia, Nigeria, Ghana, Kenya, and Tanzania, but the SDK has no geographic restriction.

Ship it this week

Start
integrating.

The Address Verify SDK is live on Maven Central, CocoaPods, Swift Package Manager, and npm. Pull v1.0.1, drop in your API key, and run a verification by the end of the day.