Verify the self-employed.
The hardest income to prove is the income no payslip or bank feed can show. Gov Connect reads it straight from HMRC. The self-employed, landlords, and pensioners, anyone earning beyond a payslip, from one authoritative tax record.
HMRC Tax Record
Tax year 2024-25
Priya Nair
NI · AB654321C
Self-employment
Sole trader · net profit
£74,100
self_employments
Dividends
UK dividends
£18,000
dividends
Property income
Net rental
£12,400
properties
Income that used to be a black box.
Self-employed and complex income is where payroll connections and bank estimates run out of road. Gov Connect goes to the source of record, covering the income no payslip or bank feed can see.
Sole traders & freelancers
Turnover, expenses, and net profit per tax year. The self-employed income that never appears on a payslip.
Directors & contractors
Salary and dividends together, so limited-company income reads as one complete picture.
Pension & asset income
Pensions, rental property, and investment income for people who earn without an employer. The income no payslip can show.
The full self-employed picture, in one response.
One call returns the applicant's HMRC income record, per tax year, through the same Teal API and authorisation you already use.
- Self-employment, dividends, pensions, and property income
- Full tax-year history, confirmed at source
{
"authorisation_id": "auth_5d4c3b2a",
"income": {
"identity": { "name": "Priya Nair", "ni_number": "AB654321C" },
// Self-employment
"self_employments": [{
"business_type": "sole_trader",
"tax_year": "2024-25",
"turnover": "92500.00",
"net_profit": "74100.00"
}],
// Dividends & property
"dividends": { "tax_year": "2024-25", "uk_dividends": "18000.00" },
"properties": [{ "tax_year": "2024-25", "net_income": "12400.00" }]
}
}Government Gateway
GOV.UK · HMRC sign in
Priya is asked to authorise access to her HMRC tax record.
The official route into HMRC.
Applicants authorise through Government Gateway, the same sign-in they use for their own tax affairs. Teal manages token storage, refresh, and revocation, so you get the data through one API with no direct HMRC dependency.
Record authorisation
Capture the applicant's authorisation in the Income API, timestamped and auditable.
Sign in with Government Gateway
The applicant authenticates directly with HMRC and grants access. OAuth 2.0, hosted by GOV.UK.
Teal fetches and normalises
We retrieve the tax record, manage token refresh and revocation, and return one standard schema.
Frequently asked questions
What is Gov Connect?
Gov Connect retrieves an applicant's HMRC tax record, with their authorisation. It shows income a payslip can't, such as self-employment and property income, by tax year.
What does the applicant need to use Gov Connect?
A Government Gateway account. They sign in on HMRC's own page and authorise access.
Verify income no one else can.
Add HMRC tax records to your verification waterfall through the same API.
Get in touch