Tax Zone Lookup API

Try it out

Find out which LLTT tax zone(s) a property resides in.

Endpoints

https://land-property-platform.herokuapp.com/tax_zones

Parameters

address: (string) The address of the property as found in the database

use_polygon: (string, optional) If true then the search will use the polygon associated with the address to search. This may reside in multiple tax zones. Note: for this PoC only 3 addresses have associated polygons. Use examples below.

Examples

Requests

Request body:

{
    "address": "58, Mountain Road, Pontypandy"
}

Or curl request:

curl -X 'POST' \
  'https://land-property-platform.herokuapp.com/tax_zones' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "address": "58, Mountain Road, Pontypandy"
}'

Or using python:

import requests
import json


address = "58, Mountain Road, Pontypandy"
json_data = json.dumps({"address": address})
response = requests.post(
    "https://land-property-platform.herokuapp.com/tax_zones",
    data=json_data,
)

Or if search by land extent is required:

{
    "address": "1, Pontypandy",
    "use_polygon": true
}

Response

Response body:

{
  "north_zone": 1
}

Or with use_polygon set to true:

{
  "north_zone": 0.8522164045055316,
  "south_zone": 0.14778359549447
}

Response schema:

{
    tax_zone: proportion of property within
}