Client - MTD Foreign Properties
HMRC's register of a client's foreign properties, which exists from tax year 2026-27 onwards. A foreign property income source holds several lets, and HMRC changed how a let is named between two adjacent years: by country code up to 2025-26, by a registered property identifier from 2026-27. That makes the register a precondition for filing rather than a settings page — until a property exists, nothing about the let can be sent. Registering is not idempotent: each call creates a new property.
-
GET List Foreign PropertiesReturns the foreign properties HMRC hold registered against an income source for the tax year, each with the identifier every filing for that let name.../tenants/{tenant}/clients/{client}/mtd/foreign-properties/{businessId}/{taxYear}
-
POST Register Foreign PropertyRegisters one foreign property with HMRC and returns the identifier they issue. Each call creates a new property, so this is not safe to repeat: a dup.../tenants/{tenant}/clients/{client}/mtd/foreign-properties/{businessId}/{taxYear}
-
PUT Update Foreign PropertyRenames a registered foreign property, or records that it stopped producing income. Keyed by the property id alone — HMRC's own path shape. The countr.../tenants/{tenant}/clients/{client}/mtd/foreign-properties/property/{propertyId}/{taxYear}