Right To Work Checker

Right To Work Checker

Free API to verify UK share codes against gov.uk. JSON in, JSON out — in under 15 seconds.

Direct gov.uk lookup
Live session against the official check.
No data stored
Every check is stateless. Nothing persists.
~15s response
Median end-to-end time from request to JSON.
Try it
Or call the API
curl
curl -X POST https://your-host.example/api/check \
  -H 'content-type: application/json' \
  -d '{
    "share_code": "AB1CD2EF3",
    "date_of_birth": "1990-01-01",
    "company_name": "Acme Ltd"
  }'
JavaScript
const res = await fetch('/api/check', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    share_code: 'AB1CD2EF3',
    date_of_birth: '1990-01-01',
    company_name: 'Acme Ltd',
  }),
});
const data = await res.json();
Sample response
{
  "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 on a visitor’s behalf using their own share code.

What does it cost?

Nothing. The API is free to use. No signup, no API key, no rate-card.

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.