Register Foreign Property

POST /tenants/{tenant}/clients/{client}/mtd/foreign-properties/{businessId}/{taxYear}

Registers 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 duplicate leaves the client with two identical lets and figures split between them. The name must be unique among the client's properties in that country.

Parameters

Name	Type	Description
tenant*	path string	The Tenant.Code
The Tenant.Code
client*	path string
businessId*	path string
taxYear*	path string

Request Body*

RegisterMtdForeignPropertyRequest

{
  "countryCode": "string",
  "propertyName": "string",
  "endDate": "2024-01-01",
  "endReason": "Unknown"
}

Responses

200 OK

MtdForeignPropertyCreatedDto

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found