DEV Community

John Carter
John Carter

Posted on

Right to Rent Share Code: A Developer-Friendly Guide to UK Immigration Verification

Building a property platform? Managing tenant onboarding? Here's everything developers and tech teams need to know about the Right to Rent share code system.
If you're working on property tech, tenant management systems, or any application that handles UK rentals, you'll eventually encounter the Right to Rent share code. It's the government's digital solution for verifying a tenant's immigration status before they can legally rent property in England.
Understanding how this system works isn't just useful for landlords. It's essential knowledge for anyone building tools in the property space.

What Is a Right to Rent Share Code

A Right to Rent share code is a unique alphanumeric code that allows landlords or letting agents to verify a tenant's right to rent in the UK. The system is managed by the Home Office and provides real-time immigration status checks.
Instead of handling physical documents like passports or visas, tenants generate a temporary share code through the government portal. This code, combined with the tenant's date of birth, allows landlords to view their immigration status digitally.
The code is valid for 30 days from generation. After that, tenants need to generate a new one if verification hasn't been completed.
From a technical perspective, it's essentially a token-based authentication system. The share code acts as a temporary access token, granting read-only access to specific immigration data.

Who Needs to Use the Share Code System

Not every tenant uses share codes. The system applies to specific groups:
→ Non-UK and non-Irish citizens with digital immigration status
→ EU, EEA, and Swiss citizens who settled under the EU Settlement Scheme
→ Visa holders with biometric residence permits or eVisas
→ Anyone whose immigration status is recorded digitally rather than in physical documents
British and Irish citizens don't need share codes. They verify their right to rent using passports or other physical documents.
For developers building tenant onboarding flows, this means your system needs to handle both pathways. Digital verification via share codes and manual document uploads for those with physical proof.

How the Share Code System Works

The process follows a straightforward flow:
Step One: Tenant Generates Code
Tenants visit the government portal at gov.uk/prove-right-to-rent. They log in using their identity credentials (typically linked to their visa application). The system generates a nine-character alphanumeric share code.
Step Two: Tenant Shares Code
The tenant provides the share code and their date of birth to the landlord or agent. This can be done verbally, via email, or through whatever system you've built.
Step Three: Landlord Verifies
The landlord visits gov.uk/view-right-to-rent and enters the share code plus the tenant's date of birth. The system returns the tenant's immigration status, including any restrictions on their right to rent.
Step Four: Landlord Records Check
The landlord must record that the check was completed, when it was done, and what the outcome was. This creates an audit trail for compliance.

Key Technical Considerations for Developers

If you're building property tech that incorporates Right to Rent verification, several factors matter.
No Public API
Currently, the Home Office doesn't offer a public API for Right to Rent checks. Verification must happen through the government portal. This limits automation possibilities and means you can't build fully integrated verification flows without manual steps.
Data Handling
When tenants share codes through your platform, you're handling sensitive personal data. Date of birth plus immigration status requires appropriate security measures and GDPR compliance.
Time-Limited Codes
Share codes expire after 30 days. Your system should prompt tenants to generate fresh codes if verification isn't completed promptly. Building reminder notifications helps prevent delays in onboarding.
Follow-Up Checks
Some tenants have time-limited right to rent. Landlords must conduct follow-up checks before their permission expires. If you're building property management software, scheduling these follow-up verifications is a valuable feature.
Audit Trail Requirements
Landlords need records of all checks performed. Your system should log when checks were initiated, when they were completed, and what the outcome was. This protects landlords from civil penalties.

Common Implementation Challenges

Building around the share code system presents several challenges.
User Experience Friction
The multi-step process creates friction. Tenants must leave your platform, visit the government site, generate a code, then return and input it. Streamlining this with clear instructions and progress tracking improves completion rates.
Error Handling
Share codes can be entered incorrectly. Date formats vary. Expired codes cause failures. Robust error handling with clear user feedback is essential.
Edge Cases
Some tenants have complex immigration histories. Pending applications. Appeals in progress. Status changes mid-tenancy. Your system needs to handle these gracefully rather than assuming binary right/no right outcomes.
Compliance Burden
Landlords face significant penalties for failing to conduct proper checks. If your platform handles verification, you're taking on responsibility for helping users stay compliant. Clear documentation and audit features matter.

Penalties for Getting It Wrong

The compliance stakes are high.
Landlords who rent to tenants without the right to rent can face civil penalties up to £20,000 per tenant. Repeat offences can result in criminal prosecution with unlimited fines or imprisonment.
Using the share code system correctly provides landlords with a statutory excuse. This means if they conducted the check properly and it showed valid status, they're protected even if the information later proves incorrect.
For developers, building systems that help landlords achieve this statutory excuse is a genuine value proposition.

Final Thoughts

The Right to Rent share code system represents the government's push toward digital immigration verification. While it lacks the API access that would make full automation possible, understanding how it works is essential for anyone building in the property tech space.
Whether you're creating tenant onboarding tools, property management platforms, or landlord compliance systems, the share code will be part of your workflow.
For a complete guide on Right to Rent share codes including step-by-step instructions for landlords and tenants

Top comments (0)