Property Links
Create property link on client's behalf
This endpoint allows an agent user to link a property to their client's 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 the View Property Link endpoint 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/clients/all/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
CreateClientPropertyLinkRequestSchemaJson required— unresolved $ref
Response
CreateClientPropertyLinkResponseSchemaJson required— unresolved $ref