RegisterMtdForeignPropertyRequest
Registers a foreign property with HMRC so figures can be filed against it (2026-27 onwards).
HMRC issue the identifier.
Not idempotent: each registration creates a new property, so a repeated request leaves the
client with two identical lets and no way to tell which one the figures belong to.
Properties
| Name | Type | Description |
|---|---|---|
| countryCode* | string | ISO 3166-1 alpha-3 code for the country the property is in, e.g. "FRA". |
ISO 3166-1 alpha-3 code for the country the property is in, e.g. "FRA". | ||
| propertyName* | string | A name for the property. Must be unique among the client's properties in that country, |
A name for the property. Must be unique among the client's properties in that country, | ||
| endDate | string | When income stopped being received from the property, if it already has. Must be paired with |
When income stopped being received from the property, if it already has. Must be paired with | ||
| endReason | enum | Unknown NoLongerRentingPropertyOut Disposal AddedInError Cessation |
Unknown NoLongerRentingPropertyOut Disposal AddedInError Cessation | ||
JSON Example
{
"countryCode": "string",
"propertyName": "string",
"endDate": "2024-01-01",
"endReason": "Unknown"
}