# HMRC UK Tax Authority

**Canonical:** https://apis.io/providers/hmrc/  
**Website:** https://www.gov.uk/government/organisations/hm-revenue-customs  
**APIs profiled:** 8

HM Revenue and Customs (HMRC) provides over 115 APIs through the HMRC Developer Hub for UK tax compliance including Making Tax Digital for VAT and Income Tax, PAYE, customs declarations, corporation tax, and construction industry scheme. APIs use OAuth 2.0 and support both REST and XML protocols with a sandbox testing environment.

## Kin Score — 46.9 / 100 (developing)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 46.9).

| Facet | Score |
|---|---|
| Discoverability | 74.1 |
| Contract Quality | 63.6 |
| Governance | 9.8 |
| Contract Governance | 9.8 |
| Operational Transparency | 26.3 |
| Developer Ergonomics | 52.4 |
| Commercial Clarity | 13.2 |
| Access Clarity | 13.2 |

Regulatory layer — **Government & Public Sector**: 61.1 (matched via tags).

## Agent readiness — 29.1 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (8)

- **HMRC Self Assessment API** — The HMRC Self Assessment APIs enable software to submit and manage self assessment tax returns, income sources, and tax calculations for individuals and sole traders under Makin...
- **HMRC PAYE (Pay As You Earn) API** — The HMRC PAYE APIs enable payroll software to submit employer payroll data, retrieve tax codes and employee records, and manage PAYE submissions for Real Time Information (RTI) ...
- **HMRC Customs Declarations API** — The HMRC Customs Declarations APIs enable customs software to submit import and export declarations, manage authorizations, and integrate with the UK Customs Declaration Service...
- **HMRC Corporation Tax API** — The HMRC Corporation Tax APIs enable accounting software to submit corporation tax returns, retrieve liabilities, manage payments, and access tax calculation data for UK busines...
- **HMRC UK Tax Authority Liabilities API** — VAT financial liabilities
- **HMRC UK Tax Authority Obligations API** — VAT return filing obligations
- **HMRC UK Tax Authority Payments API** — VAT payments made to HMRC
- **HMRC UK Tax Authority Returns API** — VAT return submission

## Agentic access (1)

- **Hmrc Agentic Access** — 5 operations · 1 acting

## Security (3)

- **Hmrc Authentication** — oauth2 · 1 scheme
- **Hmrc Domain Security** — TLSv1.3 · HSTS · DNSSEC · DMARC
- **Hmrc Vulnerability Disclosure** — Hackerone · security.txt · contact published

## Plans (1)

- **Hmrc Plans Pricing**

## Tags

Government, Making Tax Digital, Regulatory, Tax, UK

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/hmrc/). Scores are computed from the provider's own public artifacts under a published rubric.