HM

HM Revenue & Customs

@hmrc
The UK's tax, payments and customs authority.
  • Business Source Adjustable Summary (MTD)@hmrc/business-source-adjustable-summary-mtd

    Tax: trigger, retrieve and adjust self-employment and property business summaries

    Last change212
    Updated on 2026-10-16
  • Individuals Expenses (MTD)@hmrc/individuals-expenses-mtd

    Tax: record, retrieve and delete individuals' employment and other expenses for a tax year

    Last change1
    Updated on 2026-10-10
  • Customs Inventory Linking Exports@hmrc/customs-inventory-linking-exports-2

    UK customs: submit inventory linking export requests using XML schema messages

    Last changeNo API changes
    Updated on 2026-09-26
  • Customs Declarations@hmrc/customs-declarations-2

    Customs: submit, amend and cancel declarations, arrival notifications and file uploads

    Last changeNo API changes
    Updated on 2026-09-23
  • Business Details (MTD)@hmrc/business-details-mtd

    UK tax: look up and update self-employment and property business details, accounting types and periods

    Last change1
    Updated on 2026-09-16
  • CIS Deductions (MTD)@hmrc/cis-deductions-mtd

    Tax: retrieve, create, amend and delete CIS deductions for subcontractors

    Last changeNo API changes
    Updated on 2026-08-30
  • Customs Declarations Information@hmrc/customs-declarations-information-2

    Customs: look up declaration status, versions and full details by MRN, DUCR, UCR or inventory reference

    Last changeFirst revision
    Updated on 2026-07-23
  • Individual Calculations (MTD)@hmrc/individual-calculations-api

    Tax: trigger, list and retrieve Self Assessment calculations and submit final declarations

    Last changeFirst revision
    Updated on 2026-07-13
  • VAT (MTD)@hmrc/vat-api

    Tax: submit VAT returns, view obligations, liabilities, payments and penalties for a VAT number

    Last changeFirst revision
    Updated on 2026-07-13
  • VAT Assist (MTD)@hmrc/mtd-transaction-risking

    VAT: pre-submission HMRC Assist feedback on draft returns and acknowledgements

    Last changeFirst revision
    Updated on 2026-07-13
  • Self Employment Business (MTD)@hmrc/self-employment-business-api

    Tax: submit self-employment period summaries, annual adjustments and cumulative figures for sole traders

    Last changeFirst revision
    Updated on 2026-07-13
  • Self Assessment Accounts (MTD)@hmrc/self-assessment-accounts-api

    Tax: view Self Assessment balances, charges and payments, manage tax code coding out, and check ITSA penalties

    Last changeFirst revision
    Updated on 2026-07-13
  • Trader Goods Profile test support@hmrc/trader-goods-profiles-test-support

    Test support: patch existing goods records for the Trader Goods Profile service

    Last changeFirst revision
    Updated on 2026-07-13
  • View Self Assessment Account@hmrc/self-assessment-liability-api

    Tax: look up a UK Self Assessment account's breakdown by UTR

    Last changeFirst revision
    Updated on 2026-07-13
  • Trader Goods Profile@hmrc/trader-goods-profiles

    Customs: maintain trader goods profiles, goods records and HMRC commodity code advice

    Last changeFirst revision
    Updated on 2026-07-13
  • Self Assessment Individual Details (MTD)@hmrc/self-assessment-individual-details-api

    Tax: retrieve a person's Making Tax Digital for Income Tax (ITSA) status by National Insurance number and tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Property Business (MTD)@hmrc/property-business-api

    Property income: submit UK and foreign rental income and expenses, annual and quarterly, plus holiday lettings

    Last changeFirst revision
    Updated on 2026-07-13
  • Self Assessment Test Support (MTD)@hmrc/mtd-sa-test-support-api

    Sandbox test data: create test businesses and ITSA statuses, manage state checkpoints

    Last changeFirst revision
    Updated on 2026-07-13
  • Test Fraud Prevention Headers@hmrc/txm-fph-validator-api

    Fraud prevention: validate request headers and retrieve validation feedback per API

    Last changeFirst revision
    Updated on 2026-07-13
  • Safety and security import control entry summary declarations@hmrc/import-control-entry-declaration-store

    Customs: submit and amend import entry summary declarations for goods

    Last changeFirst revision
    Updated on 2026-07-13
  • Self Assessment Assist (MTD)@hmrc/self-assessment-assist

    Tax: generate HMRC Assist reports for self-assessment customers and acknowledge them

    Last changeFirst revision
    Updated on 2026-07-13
  • Secure Data Exchange Service - File Upload API@hmrc/secure-data-exchange-service-misc-api

    Secure file exchange: create upload URLs for files and metadata via web forms

    Last changeFirst revision
    Updated on 2026-07-13
  • Safety and security import control entry summary declaration notifications@hmrc/import-control-entry-declaration-intervention

    Customs: list, retrieve and acknowledge import declaration notifications

    Last changeFirst revision
    Updated on 2026-07-13
  • Safety and security import control entry summary declaration outcomes@hmrc/import-control-entry-declaration-outcome

    Customs: list, retrieve and acknowledge import entry summary declaration outcomes

    Last changeFirst revision
    Updated on 2026-07-13
  • Pull Notifications API@hmrc/api-notification-pull

    Notifications: fetch pulled and unpulled messages by conversation, ID or queue, and delete queued items

    Last changeFirst revision
    Updated on 2026-07-13
  • Push Pull Notifications@hmrc/push-pull-notifications-api

    Notifications: list pending messages from a box and acknowledge them once processed

    Last changeFirst revision
    Updated on 2026-07-13
  • Customs: check Notification of Presentation waiver status for up to 3,000 EORI numbers

    Last changeFirst revision
    Updated on 2026-07-13
  • Pillar 2 API@hmrc/pillar2-submission-api

    Tax: submit and amend Pillar 2 returns, notifications and test organisations, and check obligations

    Last changeFirst revision
    Updated on 2026-07-13
  • Tax relief: check whether an individual is a Scotland, Wales or rest-of-UK resident

    Last changeFirst revision
    Updated on 2026-07-13
  • Other Deductions (MTD)@hmrc/other-deductions-api

    Tax: retrieve, create, update and delete other deductions for individuals by tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Obligations (MTD)@hmrc/obligations-api

    Tax: check income and expenditure and final declaration obligations for Self Assessment

    Last changeFirst revision
    Updated on 2026-07-13
  • Marriage Allowance Test Support@hmrc/marriage-allowance-des-stub

    Test data: create Marriage Allowance status and eligibility records for sandbox use

    Last changeFirst revision
    Updated on 2026-07-13
  • Marriage Allowance@hmrc/marriage-allowance

    Tax: check Self Assessment users' spousal tax transfer status and eligibility

    Last changeFirst revision
    Updated on 2026-07-13
  • Interest Restriction Return@hmrc/interest-restriction-return

    Tax: appoint or revoke reporting companies and submit interest restriction returns

    Last changeFirst revision
    Updated on 2026-07-13
  • National Insurance Test Support@hmrc/national-insurance-des-stub

    Tax testing: create National Insurance annual summary test data for a Self Assessment record

    Last changeFirst revision
    Updated on 2026-07-13
  • National Insurance@hmrc/national-insurance

    Tax: retrieve annual contribution summaries for self-assessment taxpayers by tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Savings Income (MTD)@hmrc/individuals-savings-income-api

    Individual tax: manage UK savings accounts and other savings income for taxpayers

    Last changeFirst revision
    Updated on 2026-07-13
  • Lifetime ISA@hmrc/lisa-api

    Government savings: open and close accounts, request bonuses, report withdrawals and life events

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Pensions Income (MTD)@hmrc/individuals-pensions-income-api

    Tax: retrieve, create, amend and delete individuals' pensions income records by tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals State Benefits (MTD)@hmrc/individuals-state-benefits-api

    Tax: record, amend and ignore individuals' state benefits by tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Partner Income (MTD)@hmrc/individuals-partner-income-api

    Tax: submit, amend, retrieve and delete individuals' partnership income for a tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Initiate payment@hmrc/third-party-payments-external-api

    Payments: start HMRC payment journeys and check their status

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Reliefs (MTD)@hmrc/individuals-reliefs-api

    Tax: manage individuals' investment, pension, charitable giving and other reliefs by tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Tax Liability Adjustments (MTD)@hmrc/individuals-tax-liability-adjustments-api

    Tax: retrieve, create, amend and delete individual tax liability adjustments by National Insurance number and tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Employments Income (MTD)@hmrc/individuals-employments-income-api

    Tax: manage employment income, financial details and student loan benefits for UK taxpayers

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Charges (MTD)@hmrc/individuals-charges-api

    Tax: manage individuals' pension charges, high income child benefit charges and winter fuel payments

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Expenses (MTD)@hmrc/individuals-expenses-api

    Tax: manage individuals' employment and other expenses for a tax year, including retrieve, submit, ignore and delete

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Dividends Income (MTD)@hmrc/individuals-dividends-income-api

    Tax: create, amend, retrieve and delete individuals' dividends income for MTD returns

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Disclosures (MTD)@hmrc/individuals-disclosures-api

    Tax: manage individuals' disclosures, including marriage allowance claims for a tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Foreign Income (MTD)@hmrc/individuals-foreign-income-api

    Tax: retrieve, create, update and delete individuals' foreign income records for a tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Insurance Policies Income (MTD)@hmrc/individuals-insurance-policies-income-api

    Tax: retrieve, create, amend and delete individuals' insurance policies income by tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Other Income (MTD)@hmrc/individuals-other-income-api

    Tax: retrieve, create, amend and delete individuals' other income for a tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individual PAYE Test Support@hmrc/paye-des-stub

    Test data: create benefits, Child Benefit, employment, income and tax summaries for SA taxpayers

    Last changeFirst revision
    Updated on 2026-07-13
  • Business Source Adjustable Summary (MTD)@hmrc/self-assessment-bsas-api

    Tax: trigger, retrieve and adjust self-employment and property business summaries for self-assessment

    Last changeFirst revision
    Updated on 2026-07-13
  • Individual Tax@hmrc/individual-tax

    Tax: retrieve individuals' annual tax summaries for Self Assessment and PAYE reconciliation

    Last changeFirst revision
    Updated on 2026-07-13
  • Individual Losses (MTD)@hmrc/individual-losses-api

    Tax: retrieve, create, amend and delete individual business losses and loss claims by tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Individuals Capital Gains Income (MTD)@hmrc/individuals-capital-gains-income-api

    UK tax: create, amend and delete capital gains from property disposals and other disposals

    Last changeFirst revision
    Updated on 2026-07-13
  • Individual Income@hmrc/individual-income

    Tax: retrieve individuals' annual income summaries for Self Assessment taxpayers

    Last changeFirst revision
    Updated on 2026-07-13
  • Individual Benefits@hmrc/individual-benefits

    Tax: retrieve annual benefits summaries and Child Benefit entitlement for Self Assessment taxpayers

    Last changeFirst revision
    Updated on 2026-07-13
  • Goods Vehicle Movements@hmrc/goods-movement-system-haulier-api

    Customs: create, amend, list and delete goods movement records for vehicles

    Last changeFirst revision
    Updated on 2026-07-13
  • ISA Returns API@hmrc/disa-returns

    Tax: submit monthly ISA subscription reports, declare them complete, and retrieve processing results

    Last changeFirst revision
    Updated on 2026-07-13
  • ICS2 Presentation Of Goods@hmrc/import-control-presentation-of-goods

    Customs: submit presentation of goods declarations for import control safety and security

    Last changeFirst revision
    Updated on 2026-07-13
  • Individual Employment@hmrc/individual-employment

    Employment: retrieve an individual's annual employment history and summary for a tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Excise Movement Control System API@hmrc/excise-movement-control-system-api

    Excise duty: submit and track excise movements, messages and trader checks

    Last changeFirst revision
    Updated on 2026-07-13
  • Hello World@hmrc/api-example-microservice

    Test and tutorial: say hello to check unrestricted, user and application-level access to HMRC APIs

    Last changeFirst revision
    Updated on 2026-07-13
  • Customs Declarations@hmrc/customs-declarations

    Customs: submit, amend and cancel declarations, plus arrival notifications and uploads

    Last changeFirst revision
    Updated on 2026-07-13
  • Check a UK EORI Number@hmrc/check-eori-number-api

    Customs: validate UK EORI numbers and look up registered business names and addresses

    Last changeFirst revision
    Updated on 2026-07-13
  • Business Details (MTD)@hmrc/business-details-api

    UK tax: list and manage sole trader businesses, accounting types, periods and late accounting date elections

    Last changeFirst revision
    Updated on 2026-07-13
  • Customs Declarations Information@hmrc/customs-declarations-information

    Customs: look up declaration status, versions and full records by MRN, DUCR, UCR or inventory reference

    Last changeFirst revision
    Updated on 2026-07-13
  • Check a UK VAT number@hmrc/vat-registered-companies-api

    Tax: check UK VAT numbers and look up registered business names and addresses

    Last changeFirst revision
    Updated on 2026-07-13
  • Customs Inventory Linking Exports@hmrc/customs-inventory-linking-exports

    UK customs: submit inventory linking export declarations and retrieve XML schemas and examples

    Last changeFirst revision
    Updated on 2026-07-13
  • CIS Deductions (MTD)@hmrc/cis-deductions-api

    Tax: retrieve, create, amend and delete CIS deductions for subcontractors

    Last changeFirst revision
    Updated on 2026-07-13
  • Create Test User@hmrc/api-platform-test-user

    Test accounts: create individual, organisation and agent users, list services

    Last changeFirst revision
    Updated on 2026-07-13
  • CTC Traders API@hmrc/common-transit-convention-traders

    Customs transit: send departure and arrival movements to NCTS, retrieve cached messages

    Last changeFirst revision
    Updated on 2026-07-13
  • Business Rates@hmrc/business-rates-api

    Property taxation: search properties, view valuations, and file property links, check and challenge cases

    Last changeFirst revision
    Updated on 2026-07-13
  • CTC Guarantee Balance@hmrc/common-transit-convention-guarantee-balance

    Customs: check remaining guarantee balance for transit movements

    Last changeFirst revision
    Updated on 2026-07-13
  • Business Income Source Summary (MTD)@hmrc/self-assessment-biss-api

    Tax: retrieve business income source summaries for self-assessment individuals by tax year

    Last changeFirst revision
    Updated on 2026-07-13
  • Agent Authorisation@hmrc/agent-authorisation-api

    HMRC tax agents: create, track and cancel client authorisation invitations and manage relationships

    Last changeFirst revision
    Updated on 2026-07-13
  • Bulk Data File List@hmrc/secure-data-exchange-bulk-download

    Tax data: list available bulk data files by file type

    Last changeFirst revision
    Updated on 2026-07-13
  • Agent Authorisation Test Support@hmrc/agent-authorisation-test-support-api

    Test support: accept or reject agent authorisation invitations in the sandbox

    Last changeFirst revision
    Updated on 2026-07-13