Right To Work Checker
One API call to verify UK share codes against gov.uk. JSON in, JSON out — in under 15 seconds.
Try it
Or call the API
curl -X POST https://your-host.example/api/check \
-H 'content-type: application/json' \
-H 'authorization: Bearer rtw_test_AbCdEfGhIjKlMnOp' \
-d '{
"share_code": "AB1CD2EF3",
"date_of_birth": "1990-01-01",
"company_name": "Acme Ltd"
}'const res = await fetch('https://your-host.example/api/check', {
method: 'POST',
headers: {
'content-type': 'application/json',
authorization: `Bearer ${process.env.RTW_API_KEY}`,
},
body: JSON.stringify({
share_code: 'AB1CD2EF3',
date_of_birth: '1990-01-01',
company_name: 'Acme Ltd',
}),
});
const data = await res.json();{
"outcome": "ACCEPTED",
"title": "Right to work",
"name": "JANE EXAMPLE DOE",
"date_of_birth": "1990-01-01",
"conditions": ["They can work in any job."],
"reference": "WE-EXAMPLE-12",
"photo_data_url": "data:image/jpeg;base64,/9j/4AAQ…",
"pdf_data_url": "data:application/pdf;base64,JVBERi0xLjQ…",
"checked_at": "2026-05-11T15:19:13.711Z"
}Frequently asked questions
What is a UK right-to-work share code?
A 9-character code issued by the UK Home Office that an applicant generates at gov.uk/prove-right-to-work and shares with an employer or landlord. The code expires 90 days after creation and lets the recipient view the applicant’s current right-to-work status on gov.uk.
How long does a check take?
Around 10–15 seconds. The service drives a real browser session against gov.uk/view-right-to-work, fills the form, and returns the parsed result. There is no caching — every check is live.
What does the API response include?
The applicant’s name, outcome (ACCEPTED or REJECTED), title (“Right to work” or “Right to rent”), visa permission type and dates where shown, conditions, the gov.uk reference number, the applicant’s photo as a base64 JPEG, and the gov.uk-rendered PDF as base64.
Is this affiliated with the UK government?
No. This service is not endorsed by, run by, or affiliated with HM Government, the Home Office, or gov.uk. It automates the public right-to-work check that employers and platforms otherwise perform by hand on gov.uk, using the share code the applicant has provided.
What does it cost?
The free tier includes 10 checks a month after signup, no card required. Paid tiers add volume: Pro is £14/month for 100 checks, Scale is £49/month for 500, Enterprise is custom. Every request needs an API key; test-mode keys return sandbox fixtures and are never billed.
How it works
The API drives a real session against gov.uk/view-right-to-work with your inputs and returns the structured result, including the gov.uk PDF and applicant photo.
No data is stored. Each check is stateless.