One session covers the applicant's identity, current address, sanctions screen, and right to rent. Five minutes on the phone, signed pack to the landlord. 500 verifications free every month.
Robinhood Ventures
Trusted by 2,000+ organizations worldwide.
What a letting agent owes
Paper-based screening is slow, expensive, and easy to forge. Didit replaces it with one hosted session: ID + liveness + face match + proof of address + AML + lease-eligibility check, $0.33 per applicant plus $0.20 for the address proof. 500 verifications free every month, sub-2-second verdict.
Pick the checks you want, ID, liveness, face match, sanctions, address, age, phone, email, custom questions. Drag them into a flow in the dashboard, or post the same flow to our API. Branch on conditions, run A/B tests, no code required.
Embed natively with our Web, iOS, Android, React Native, or Flutter SDK. Redirect to a hosted page. Or just send your user a link, by email, SMS, WhatsApp, anywhere. Pick what fits your stack.
Didit hosts the camera, the lighting cues, the mobile hand-off, and accessibility. While the user is in the flow, we score 200+ fraud signals in real time and verify every field against authoritative data sources. Result in under two seconds.
Real-time signed webhooks keep your database in sync the moment a user is approved, declined, or sent to review. Poll the API on demand. Or open the console to inspect every session, every signal, and manage cases your way.
Didit · Tenant KYC
Step 2 / 5
Capture the ID document
Didit · Proof of Address
Didit · Database Validation
Didit · Custom Questionnaire + OCR
Didit · AML
Didit · Linked KYC
$ curl -X POST https://verification.didit.me/v3/session/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workflow_id": "wf_tenant_screening",
"vendor_data": "applicant-42",
"expected_country": "GB"
}'$ curl https://verification.didit.me/v3/session/$SESSION/decision/ \
-H "x-api-key: $DIDIT_API_KEY"
# Decision payload (excerpted):
{ "status": "Approved",
"proof_of_address": { "status": "Approved", "address": { ... } },
"database_validation": { "service": "uk_right_to_rent" } }You are integrating Didit into a residential-leasing platform (PropTech / build-to-rent / letting-agent archetype). You owe the landlord (or your platform owes the landlord) an evidence pack on every applicant before the keys come off the hook.
Four obligations on every application:
1. Verify the applicant's identity — government ID + liveness + face match.
2. Validate the current address — utility, bank, or registry-issued letter, cross-checked against the ID.
3. Confirm lease eligibility — Right to Rent (UK) / state-of-residence (US) / residency document (EU) / national tax id (LatAm).
4. Screen the applicant against sanctions, Politically Exposed Persons (PEP), and adverse-media lists.
Optional: run the same flow against a guarantor and stitch both back to the lease record.
Pricing (verified live):
- Tenant KYC bundle: $0.33 per applicant (ID + Liveness + Face Match + IP + AML)
- Proof of Address: $0.20 per check
- Database Validation (right-to-rent / national id): variable, per-jurisdiction
- Linked guarantor KYC: $0.33 per guarantor
- First 500 KYC verifications free every month, forever
PRE-REQUISITES
- Production API key from https://business.didit.me (sandbox key in 60s, no card).
- Webhook endpoint with HMAC SHA-256 verification using the X-Signature-V2 header and your webhook secret.
- A workflow_id from the Workflow Builder that bundles ID Verification + Passive Liveness + Face Match 1:1 + Proof of Address + AML Screening + the jurisdiction-specific Database Validation node.
- Optional: a separate KYC workflow_id for the guarantor.
STEP 1 — Create the tenant session
POST https://verification.didit.me/v3/session/
Headers:
x-api-key: <your api key>
Content-Type: application/json
Body:
{
"workflow_id": "<your tenant-screening workflow id>",
"vendor_data": "<your applicant id, max 256 chars>",
"callback_url": "https://<your-app>/applications/kyc/callback",
"expected_country": "GB",
"metadata": {
"application_id": "<your internal id>",
"property_id": "<unit reference>"
}
}
Response: 201 Created with the hosted session URL. SMS or email the URL to the applicant; they complete everything on their phone in under five minutes.
STEP 2 — Read the signed webhook on KYC completion
Didit POSTs to your callback. Session statuses are Title Case With Spaces:
Body (excerpted):
{
"session_id": "<uuid>",
"vendor_data": "<your applicant id>",
"status": "Approved",
"id_verification": { "status": "Approved", "document_type": "passport", "country_code": "GB" },
"liveness": { "status": "Approved" },
"face": { "status": "Approved", "similarity_score": 0.94 },
"proof_of_address": { "status": "Approved", "document_type": "utility_bill", "address": { "line1": "10 Long Acre", "city": "London", "postal_code": "WC2E 9LH", "country": "GB" } },
"aml": { "status": "Approved", "hits": [] },
"database_validation": { "status": "Approved", "service": "uk_right_to_rent", "result": { "share_code_status": "valid", "expiry_date": "2027-08-12" } }
}
Session status enum (exact case):
Approved | Declined | In Review | Resubmitted | Expired | Not Finished | Kyc Expired | Abandoned
Verify the X-Signature-V2 header BEFORE reading the body — HMAC SHA-256 of the raw bytes with your webhook secret.
STEP 3 — (Optional) Spawn a guarantor session
If the workflow declares a guarantor step, the parent session returns a guarantor_session_url inside the decision payload. Email it to the guarantor and they run the same KYC flow on their phone. The result threads back to the parent tenant record automatically.
Alternatively, fire a second POST /v3/session/ with a separate guarantor workflow_id and stitch the two together by setting metadata.tenant_session_id on the guarantor call.
STEP 4 — Retrieve the full evidence pack
GET https://verification.didit.me/v3/session/{sessionId}/decision/
Headers:
x-api-key: <your api key>
Returns the full decision payload — ID block, liveness block, face match, proof-of-address result with the canonical address fields, AML hits, database-validation outcome. Use this for audit-pack export and for rendering the applicant status in your letting-agent dashboard.
STEP 5 — Decide
Branch logic:
Approved → forward the pack to the landlord, advance to lease signing.
In Review → hold the application, wait for analyst webhook update.
Declined → refuse the application, log the decline reason.
Resubmitted → applicant updated something; re-read the decision.
For Database Validation specifically — if the result indicates an expired Right to Rent share code, ask the applicant for a fresh one before moving forward.
STEP 6 — Ongoing monitoring (long leases)
For multi-year tenancies, enable Ongoing AML at $0.07/user/year. The session status updates automatically when the tenant lands on a new sanctions list or document expirations approach (passport, visa, residency permit). Your webhook fires on every state change.
No separate endpoint to call — the same workflow drives it.
WEBHOOK EVENT NAMES
- status.updated — session status changed.
- data.updated — session data changed (resubmission, expiry, ongoing AML hit).
Verify X-Signature-V2 on every payload. The webhook secret is per-environment — sandbox key is separate from production.
CONSTRAINTS
- Session statuses use Title Case With Spaces (Approved, In Review).
- Default record retention is 5 years per tenant per the EU AML package; UK Right to Rent requires document copies for the tenancy duration + one year.
- The address on the Proof of Address document MUST match the address on the underlying ID for an Approved outcome; if they differ, the session flips to In Review.
Read the docs:
- https://docs.didit.me/sessions-api/create-session
- https://docs.didit.me/sessions-api/retrieve-session
- https://docs.didit.me/core-technology/proof-of-address/overview
- https://docs.didit.me/core-technology/aml-screening/overview
- https://docs.didit.me/integration/webhooks
Start free at https://business.didit.me — sandbox key in 60 seconds, 500 verifications free every month, no credit card.$0 / month. No credit card required.
Pay only for what you use. 25+ modules. Public per-module pricing, no monthly minimum fee.
Custom MSA & SLA. For large volumes and regulated programs.
Start free → pay only when a check runs → unlock Enterprise for a custom contract, SLA, or data residency.
Didit is infrastructure for identity and fraud, the platform we wished existed when we were building products ourselves: open, flexible, and developer-friendly, so it works as a real part of your stack instead of a black box you integrate around.
One API covers verifying people (KYC, know your customer), verifying businesses (KYB, know your business), screening crypto wallets (KYT, know your transaction), and monitoring transactions in real time, on a stack built to be:
The footprint underneath: 14,000+ document types in 48+ languages, 1,000+ data sources, and 200+ fraud signals on every session. The Didit infrastructure dynamically learns from every session and gets better every day.
It's the process a landlord or letting agent runs before handing over the keys, to make sure the applicant is who they say they are and can lawfully take the lease. The standard pieces are:
Didit ships all of it as one hosted flow. The applicant completes it on their phone in under five minutes; the agent gets a signed pack back.
Anyone leasing residential property to a third party. In practice that means:
In the UK, Right to Rent checks are a hard legal requirement under the Immigration Act, with material per-tenant fines for failing to perform them. The EU has parallel obligations under the AML package for any property professional. The US runs it through state landlord-tenant law plus fair-housing rules.
The full flow normally takes under 30 seconds end-to-end, pick up the ID, snap the document, snap the selfie, done. That is the fastest in the market. Legacy KYC providers usually take more than 90 seconds for the same flow.
On the back end, Didit returns the result in under two seconds at p99, measured from the moment the user finishes the selfie to the moment your webhook fires. Mobile capture is tuned for slow phones and slow networks: progressive image compression, lazy software development kit load, and a one-tap hand-off from desktop to phone via QR code if the user starts on web.
Three things, in order of how often they bite:
The traditional paper-based check is slow, expensive (typically £15-£40 per applicant through legacy providers), and easy to forge. Most agents end up doing a partial check and hoping for the best. Didit eliminates the trade-off, full coverage at $0.53 per applicant (KYC bundle + Proof of Address).
Every session lands on one of seven clear statuses, so your code always knows what to do:
Approved, every check passed. Move the user forward.Declined, one or more checks failed. You can allow the user to resubmit the specific failed step (for example, re-take the selfie) without re-running the whole flow.In Review, flagged for compliance review. Open the case in the console, see every signal, decide approve or decline.In Progress, user is mid-flow.Not Started, link sent, user has not opened it yet. Send a reminder if it sits too long.Abandoned, user opened the link but did not finish in time. Re-engage or expire.Expired, the session link aged out. Create a new session.A signed webhook fires on every status change, so your database always stays in sync. Abandoned and declined sessions are free.
Production data is processed and stored in the European Union by default, on Amazon Web Services. Enterprise contracts can request alternative regions for jurisdictions whose regulators require it.
Encryption everywhere. AES-256 at rest across every database, object store, and backup. Transport Layer Security 1.3 in transit on every API call, webhook, and Business Console session. Biometric data is encrypted under a separate Customer Master Key.
Retention is yours to control. Default retention is indefinite (unlimited) unless you configure shorter, between 30 days and 10 years per application, and you can delete any individual session at any time from the dashboard or the API.
Certifications: SOC 2 Type 1 (Type 2 audit in progress), ISO/IEC 27001:2022, iBeta Level 1 PAD, and a public attestation from Spain''s Tesoro / SEPBLAC / CNMV that Didit''s remote identity verification is safer than verifying someone in person. Full report at /security-compliance.
Didit ships compliant by default for the regulators that matter to identity infrastructure:
Detailed memo, every certificate, every regulator letter: /security-compliance.
Three integration paths, pick whichever fits your stack:
Same dashboard, same billing, same pay-per-success price for all three. Step-by-step guide at docs.didit.me/integration/integration-prompt.
Three layers of validation run on every Proof of Address upload:
Fraud patterns Didit catches: a Photoshopped utility bill with a forged address, a real bill from a different building, a bill belonging to a different person at the same address, an expired bill (over 90 days old). All three layers run server-side; the agent never sees a raw upload, only the validated result.
Verification at the start of the tenancy is necessary but not sufficient, for long leases, tenants change circumstances and sanctions lists update daily. Didit's ongoing monitoring catches:
Everything flows through the same status.updated webhook you wired for onboarding. No new endpoint, no extra integration.
Most tenant-screening providers price between £15 and £40 per applicant, Goodlord, Letting a Property, Open Banking-based affordability tools. Most charge per check, plus a per-tenancy admin fee, plus a per-Right-to-Rent surcharge.
Didit's published price is $0.33 for the KYC bundle + $0.20 for Proof of Address = $0.53 per applicant. Database Validation is variable per jurisdiction and typically adds $0.05-$0.20 depending on the service. No floor, no commit, no per-country surcharge.
That's roughly 10× cheaper than the incumbent stack on the same legal output. At a 200-tenant build-to-rent portfolio that turns over once a year, the saving is around £3,000 in screening costs, and the applicant experience is faster, with no paper, no scanning. Full pricing at /pricing.
One API for KYC, KYB, Transaction Monitoring, and Wallet Screening. Integrate in 5 minutes.