HMRC UK Tax Authority

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.

HMRC UK Tax Authority publishes 4 APIs on the APIs.io network, including Liabilities API, Obligations API, Payments API, and 1 more. Tagged areas include Government, Making Tax Digital, Regulatory, Tax, and UK.

The HMRC UK Tax Authority catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

HMRC UK Tax Authority’s developer surface includes authentication, developer portal, documentation, getting-started guide, support, and 14 more developer resources.

🌐 Visit website 📡 Source on GitHub

57.6/100 strong ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

8 APIs

GovernmentMaking Tax DigitalRegulatoryTaxUK

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 57.6/100 · strong

Contract Quality 17.0 / 25

Developer Ergonomics 9.6 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 6.8 / 13

Governance 7.0 / 12

Discoverability 7.4 / 10

Agent readiness — 31/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/hmrc: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Hmrc Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

JSON Schema 11

Standalone JSON Schema definitions for this provider's data models.

Scroll for all 11

Scopes 1

OAuth scopes governing access to this provider's APIs.

Hmrc Scopes

2 scopes · authorizationCode

2 scopes

SCOPES

Get Started 2

Portal, sign-up, and the first successful call

Portal

Portal

GettingStarted

GettingStarted

Documentation 3

Reference material describing how the API behaves

Documentation

Documentation

OpenAPI

OpenAPI

JSONSchema

JSONSchema

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

JSONLDContext

JSONLDContext

Build 2

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

GitHubOrganization

Access & Security 5

Authentication, authorization, and security posture

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

Authentication

OAuthScopes

Authentication

Operate 2

Status, limits, changes, and where to get help

StatusPage

StatusPage

Support

Support

Commercial 1

Pricing, plans, and the legal terms of use

TermsOfService

TermsOfService

Company 2

The organization behind the API

LinkedIn

Website

Website

Source (apis.yml)

aid: hmrc
name: HMRC UK Tax Authority
description: 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.
url: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/apis.yml
type: Index
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png
tags:
- Government
- Making Tax Digital
- Regulatory
- Tax
- UK
created: '2025'
modified: '2026-05-19'
specificationVersion: '0.19'
apis:
- aid: hmrc:hmrc-self-assessment-api
  name: HMRC Self Assessment API
  description: 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 Making Tax Digital for Income Tax.
  humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api
  baseURL: https://api.service.hmrc.gov.uk
  image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png
  tags:
  - Government
  - Income Tax
  - REST
  - Self Assessment
  - Tax
  - UK
  properties:
  - type: Documentation
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api
  - type: Authentication
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation
- aid: hmrc:hmrc-paye-api
  name: HMRC PAYE (Pay As You Earn) API
  description: 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) reporting.
  humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api
  baseURL: https://api.service.hmrc.gov.uk
  image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png
  tags:
  - Government
  - PAYE
  - Payroll
  - REST
  - Tax
  - UK
  properties:
  - type: Documentation
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api
  - type: Authentication
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation
- aid: hmrc:hmrc-customs-declarations-api
  name: HMRC Customs Declarations API
  description: The HMRC Customs Declarations APIs enable customs software to submit import and export declarations, manage
    authorizations, and integrate with the UK Customs Declaration Service (CDS) for trade compliance.
  humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api
  baseURL: https://api.service.hmrc.gov.uk
  image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png
  tags:
  - Customs
  - Excise
  - Government
  - REST
  - Tax
  - UK
  - XML
  properties:
  - type: Documentation
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api
  - type: Authentication
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation
- aid: hmrc:hmrc-corporation-tax-api
  name: HMRC Corporation Tax API
  description: The HMRC Corporation Tax APIs enable accounting software to submit corporation tax returns, retrieve liabilities,
    manage payments, and access tax calculation data for UK businesses.
  humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api
  baseURL: https://api.service.hmrc.gov.uk
  image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png
  tags:
  - Business
  - Corporation Tax
  - Government
  - REST
  - Tax
  - UK
  properties:
  - type: Documentation
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api
  - type: Authentication
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation
- aid: hmrc:hmrc-liabilities-api
  name: HMRC UK Tax Authority Liabilities API
  description: VAT financial liabilities
  humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0
  baseURL: https://api.service.hmrc.gov.uk
  tags:
  - Liabilities
  properties:
  - type: OpenAPI
    url: openapi/hmrc-liabilities-api-openapi.yml
  - type: Documentation
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0
  - type: Reference
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0/oas/page
  - type: Authentication
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation
- aid: hmrc:hmrc-obligations-api
  name: HMRC UK Tax Authority Obligations API
  description: VAT return filing obligations
  humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0
  baseURL: https://api.service.hmrc.gov.uk
  tags:
  - Obligations
  properties:
  - type: OpenAPI
    url: openapi/hmrc-obligations-api-openapi.yml
  - type: Documentation
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0
  - type: Reference
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0/oas/page
  - type: Authentication
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation
- aid: hmrc:hmrc-payments-api
  name: HMRC UK Tax Authority Payments API
  description: VAT payments made to HMRC
  humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0
  baseURL: https://api.service.hmrc.gov.uk
  tags:
  - Payments
  properties:
  - type: OpenAPI
    url: openapi/hmrc-payments-api-openapi.yml
  - type: Documentation
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0
  - type: Reference
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0/oas/page
  - type: Authentication
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation
- aid: hmrc:hmrc-returns-api
  name: HMRC UK Tax Authority Returns API
  description: VAT return submission
  humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0
  baseURL: https://api.service.hmrc.gov.uk
  tags:
  - Returns
  properties:
  - type: OpenAPI
    url: openapi/hmrc-returns-api-openapi.yml
  - type: Documentation
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0
  - type: Reference
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0/oas/page
  - type: Authentication
    url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/hmrc-uk-tax-authority/overview
- type: AgenticAccess
  url: agentic-access/hmrc-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/hmrc-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/hmrc-domain-security.yml
- type: Authentication
  url: authentication/hmrc-authentication.yml
- type: OAuthScopes
  url: scopes/hmrc-scopes.yml
- type: GitHubOrganization
  url: https://github.com/hmrc
- type: LinkedIn
  url: https://www.linkedin.com/company/hmrc
- type: Portal
  url: https://developer.service.hmrc.gov.uk/
- type: Documentation
  url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api
- type: Authentication
  url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation
- type: GettingStarted
  url: https://developer.service.hmrc.gov.uk/api-documentation/docs/using-the-hub
- type: TermsOfService
  url: https://www.gov.uk/api-documentation/docs/terms-of-use
- type: StatusPage
  url: https://api-platform-status.production.tax.service.gov.uk/
- type: Support
  url: https://developer.service.hmrc.gov.uk/
- type: Website
  url: https://www.gov.uk/government/organisations/hm-revenue-customs
- type: OpenAPI
  url: openapi/hmrc-vat-mtd-openapi.yml
- type: JSONSchema
  url: json-schema/hmrc-vat-return-schema.json
- type: JSONLDContext
  url: json-ld/hmrc-context.jsonld
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

HMRC UK Tax Authority

APIs 8

Postman Collections 4

Open Collections 1

Pricing Plans 1