@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Deed API
@base https://api.landregistry.gov.uk/v1
@version 1.0.0
@endpoints 2
@toc deed(2)

@endpoint POST /deed/
@desc Deed
@required {body: map}
@returns(201) URL to the GET endpoint for the deed is returned on successful creation.
@errors {400: Bad Request due to invalid schema. Response will include 1 or more schema errors}

@endpoint GET /deed/{deed_reference}
@desc Deed
@required {deed_reference: any # Unique reference of the deed.}
@returns(200) A specific deed is returned
@errors {404: Deed not found}

@end