HMRC UK Tax Authority · Authentication Profile

Hmrc Authentication

Authentication

HMRC UK Tax Authority secures its APIs with oauth2 across 1 declared security scheme, as derived from its OpenAPI definitions. OAuth 2.0 is offered via the authorizationCode flow(s).

GovernmentMaking Tax DigitalRegulatoryTaxUK
Methods: oauth2 Schemes: 1 OAuth flows: authorizationCode API key in:

Security Schemes

OAuth2UserRestricted oauth2
· flows: authorizationCode

Source

Authentication Profile

Raw ↑ 
generated: '2026-07-11'
method: derived
source: openapi/hmrc-vat-mtd-openapi.yml
summary:
  types:
  - oauth2
  oauth2_flows:
  - authorizationCode
schemes:
- name: OAuth2UserRestricted
  type: oauth2
  flows:
  - flow: authorizationCode
    authorizationUrl: https://api.service.hmrc.gov.uk/oauth/authorize
    tokenUrl: https://api.service.hmrc.gov.uk/oauth/token
    scopes: 2
  description: HMRC OAuth 2.0 Authorization Code grant (user-restricted)
  sources:
  - openapi/hmrc-vat-mtd-openapi.yml