aid: hmrc url: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/apis.yml apis: - aid: hmrc:hmrc-vat-mtd-api name: HMRC VAT (Making Tax Digital) API tags: - Government - Making Tax Digital - REST - Tax - UK - VAT image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0 baseURL: https://api.service.hmrc.gov.uk properties: - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0 type: Documentation - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/vat-api/1.0/oas/page type: Reference - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation type: Authentication - url: openapi/hmrc-vat-mtd-openapi.yml type: OpenAPI description: >- The HMRC VAT (Making Tax Digital) API enables software to submit VAT returns, retrieve VAT obligations, liabilities, payments, penalties, and customer details in compliance with UK Making Tax Digital requirements. Uses OAuth 2.0 authentication with fraud prevention headers required. - aid: hmrc:hmrc-self-assessment-api name: HMRC Self Assessment API tags: - Government - Income Tax - REST - Self Assessment - Tax - UK image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api baseURL: https://api.service.hmrc.gov.uk properties: - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api type: Documentation - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation type: Authentication 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. - aid: hmrc:hmrc-paye-api name: HMRC PAYE (Pay As You Earn) API tags: - Government - PAYE - Payroll - REST - Tax - UK image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api baseURL: https://api.service.hmrc.gov.uk properties: - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api type: Documentation - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation type: Authentication 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. - aid: hmrc:hmrc-customs-declarations-api name: HMRC Customs Declarations API tags: - Customs - Excise - Government - REST - Tax - UK - XML image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api baseURL: https://api.service.hmrc.gov.uk properties: - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api type: Documentation - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation type: Authentication 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. - aid: hmrc:hmrc-corporation-tax-api name: HMRC Corporation Tax API tags: - Business - Corporation Tax - Government - REST - Tax - UK image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png humanURL: https://developer.service.hmrc.gov.uk/api-documentation/docs/api baseURL: https://api.service.hmrc.gov.uk properties: - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api type: Documentation - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation type: Authentication 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. common: 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. image: https://raw.githubusercontent.com/api-evangelist/hmrc/refs/heads/main/image.png tags: - Government - Tax - UK - Making Tax Digital - Regulatory properties: - url: https://developer.service.hmrc.gov.uk/ type: Portal - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/api type: Documentation - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/authorisation type: Authentication - url: https://developer.service.hmrc.gov.uk/api-documentation/docs/using-the-hub type: Getting Started - url: https://www.gov.uk/api-documentation/docs/terms-of-use type: Terms of Service - url: https://api-platform-status.production.tax.service.gov.uk/ type: Status - url: https://developer.service.hmrc.gov.uk/ type: Support - url: https://www.gov.uk/government/organisations/hm-revenue-customs type: Website - url: openapi/hmrc-vat-mtd-openapi.yml type: OpenAPI - url: json-schema/hmrc-vat-return-schema.json type: JSONSchema - url: json-ld/hmrc-context.jsonld type: JSONLDContext maintainer: name: Kin Lane email: kin@apievangelist.com modified: '2026-03-18' description: >- Your feedback (opens in new tab) will help us to improve this service.