Property Links

Create property link

This endpoint allows a user to link a property to their organisation.

Once you requested has been accepted there will a slight delay in processing the request (approximately a minute).

To confirm your request has completed you can poll Get Singular Property Link. to see if you can move onto the next step.

We recommend you don’t poll until a minute after the initial request was submitted.

Once you have confirmation your request has been processed you can then move onto uploading your evidence.

Once the property link has been approved by the VOA the user will be able to:

  • View the detailed valuation for the property
  • Submit a request to amend the details the VOA have for the property
  • Challenge the valuation

Note that:

  • The request will be processed by the VOA with human intervention. The state will be updated and is available via the view property link endpoint.
post/my-organisation/property-links

Headers

Accept'application/vnd.hmrc.2.0+json' required

Specifies the response format and the version of the API to be used

Request body

CreatePropertyLinkRequestSchemaJson required— unresolved $ref

Response

CreatePropertyLinkResponseSchemaJson required— unresolved $ref