HMRC tax APIs and schemas

Source universe · Acquisition routes

Official implementation · Official API · Public

Published by HM Revenue & Customs. Jurisdiction: UK.

What it covers

• VAT
• Income Tax
• PAYE
• Customs
• API schemas
• software integration

Publication and history

APIs have separate versions, deprecations, OAuth scopes, production approvals and outage states.

Versioned API documentation and schemas; availability differs by tax regime and approval status.

Review cadence: Daily. Reliability: Official publisher.

Acquisition and rights

• Acquisition: Official API

• Licence: Open Government Licence v3.0

• Commercial reuse: Permitted with attribution

• Raw storage: Permitted

• Derived assertions: Permitted

• Public use: Attributed derived content

• Visibility: Public

Register an application, obtain the required production approval and OAuth scopes, and respect the standard three requests per second per application limit.

Contains public sector information licensed under the Open Government Licence v3.0; credited third-party material remains excluded.

Evidence for this decision

• HMRC API documentation — Access evidence, reviewed 11 September 2026.
• HMRC API reference and rate limits — Access evidence, reviewed 11 September 2026.
• HMRC Developer Hub terms — Terms evidence, reviewed 11 September 2026.

Source registry: sterling-source-registry@2026-09-11.5. Last reviewed 11 September 2026.