# NZ Property Title

### nzPropertyTitle <a href="#nzpropertytitle" id="nzpropertytitle"></a>

Takes an single line address or semi-structure address or latitude, longitude as an input and performs property ownership validation, return validated result as passed or failed.

#### Resource URLs

```
    POST(component)   	
    https://hosted.mastersoftgroup.com/harmony/rest/nz/validate/propertyTitle/component
    
    GET(component)   	
    https://hosted.mastersoftgroup.com/harmony/rest/nz/validate/propertyTitle/component?firstName=John&lastName=Doe&streetNumber=000&street=xxx&suburb=MT EDEN&townCity=ACUKLAND&postcode=1024
    
    POST(singleLine)
    https://hosted.mastersoftgroup.com/harmony/rest/nz/validate/propertyTitle/address
    
    GET(singleLine)   	
    https://hosted.mastersoftgroup.com/harmony/rest/nz/validate/propertyTitle/address?firstName=John&lastName=Doe&fullAddress=000 xxxx st, wellington central, wellington&showDetails=true
    	
    POST(latLong)   	
    https://hosted.mastersoftgroup.com/harmony/rest/nz/validate/propertyTitle/latlong
    
    GET(latLong)   		
    https://hosted.mastersoftgroup.com/harmony/rest/nz/validate/propertyTitle/latlong?firstName=John&lastName=Doe&latitude=-41.xxxxxxx&longitude=174.xxxxxx&showDetails=true
```

#### Request

The request body is a [PropertyTitleRestRequest ](https://docs.mastersoftgroup.com/loqate-harmony-api/objects/property-title-objects#propertytitlerestrequest)object:

```
   {
        "payload": {
            "firstName":"John", 
            "lastName":"Doe", 
            "streetNumber":"000", 
            "street":"xxxxx st", 
            "suburb":"wellington central", 
            "townCity":"wellington"
        },
        "showDetails":"true"
    }
    
```

#### Response

The response body is a [PropertyTitleRestResponse ](https://docs.mastersoftgroup.com/loqate-harmony-api/objects/property-title-objects#propertytitlerestresponse)object:

```
     {
        {
            "status":"SUCCESS",
            "messages":[],
       	    "payload":{
                "response":"fail",
                "attributes":[
                    {
                        "type":"NZ_PROPERTY_TITLE",
                        "attributes":{
                            "guaranteeStatus":"Guarantee",
                            "status":"LIVE",
                            "descrption":"Fee Simple, 1/1, Lot x Deposited Plan xxx, 401 m2",
                            "spatialExtensShared":"T",
                            "ownsNumber":"1",
                            "issueDate":"1986/09/10 00:00:00",
                            "titleNo":"xxxx",
                            "type":"Freehold",
                            "owners":"xxxx",
                            "titleId":"xxxx",
                            "landDistrict":"Wellington"
                        }
                    }
                ]
            }
        }
    }
    
```