Address Verification
Proof of address, verified automatically.
Utility bills and bank statements arrive as photos and PDFs in every format imaginable. Amani classifies the document, extracts the name and address, checks recency and consistency with the verified identity - and returns a clean result.
Capabilities
What Address Verification gives you.
Any proof document
Utility bills, bank statements, tenancy contracts and government letters classified automatically.
Extraction & matching
Name and address extracted and matched against the verified identity, with transliteration handled.
Recency rules
Configurable document-age limits (30/60/90 days) enforced from the document’s own date.
Tamper checks
Edited PDFs and composited images flagged before an address ever enters your records.
Right to Rent ready
Supports UK Right to Rent and similar residency-check regimes out of the box.
Structured output
Normalised address fields returned ready for your CRM, credit or delivery systems.
From session to signed result.
Four steps - the same integration pattern as every Amani module.
Create a session
One API call (or a Studio journey) starts a verification session for this module.
User completes the flow
Your customer is guided through capture in your branded UI - web or mobile.
Checks run in real time
Address Verification executes alongside any other modules in the journey.
You receive a signed result
A webhook delivers the decision, scores and evidence to your backend.
For developers
Integrate Address Verification.
Authenticate, create a profile, generate a verification URL - then let Amani handle the rest. Or describe what you want to your AI coding agent and let Amani Skills wire it up from the live docs.
Available on
verify.sh
# 1 · Authenticate (server-side only)
curl -X POST 'https://ae.amani.ai/api/v2/user/login/' \
--form 'username="you@company.com"' \
--form 'password="••••••••"'
# 2 · Create the customer profile
curl -X POST 'https://ae.amani.ai/api/v2/profile' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
--form 'id_card_number="784199012345678"' \
--form 'name="Layla Haddad"'
# 3 · Generate the verification URL
curl -X POST 'https://ae.amani.ai/api/v2/profile/url' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
--data '{
"profile": PROFILE_ID,
"web_sdk_url": "https://verify.amani.ai",
"language": "en",
"return_url": "https://yourapp.com/verified"
}'
# Address Verification runs inside this session - configure it in Amani Studio.with Amani Skills
# Install Amani Skills once
npx -y github:AMANI-AI-ORG/skills --global
# Then ask your coding agent:
You › Collect and verify a proof-of-address document with Amani in our React onboarding flow.
# The matching skill fetches the live docs, pins the
# current SDK version and wires up the integration -
# secrets left as placeholders. Claude Code, Cursor and
# any Agent-Skills-compatible tool.webhooks.ts
// Amani signs every webhook with an HMAC signature using
// your secret. Always verify it before processing.
import crypto from 'node:crypto';
app.post('/webhooks/amani', (req, res) => {
// Confirm the exact header name in the Webhooks API reference.
const signature = req.get('X-Amani-Signature') ?? '';
const expected = crypto
.createHmac('sha256', process.env.AMANI_WEBHOOK_SECRET)
.update(req.rawBody)
.digest('hex');
const valid =
signature.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
if (!valid) return res.status(401).end();
const { profile, status } = req.body;
if (status === 'approved') activateAccount(profile);
res.status(200).end();
});Address Verification - common questions
Which documents count as proof of address?
You choose per journey - commonly utility bills, bank statements and government correspondence within your recency window.
Does it verify the address is real?
Address structure is validated and normalised; where postal reference data is available, existence checks run too.
How are non-Latin documents handled?
OCR and matching support Arabic, Turkish and other major scripts, with transliteration-aware name comparison.
Related modules
Add Address Verification to your flow
Switch it on in Amani Studio, or call it directly from the API.