Council tax by address

England
Wales
gethttps://crystalroof.co.uk/customer-api/council-tax/address/v1/{address}

Description

This method returns the council tax band and the corresponding council tax figure.

Council tax bands are retrieved for each individual property, with tax values derived from levels set by local authorities. Figures include adult social care and parish precepts.

Address Format Recommendations

This method utilises sophisticated heuristics to match the searched property address to the council tax database. In 99% of cases, a match is found. However, please follow the recommendations below to achieve the best results:

  1. The address should be sufficient to identify the exact property. If several properties correspond to the input, the method will return an error.
  2. Best results are achieved when using the address derived from the SINGLE_LINE_ADDRESS field of the OS AddressBase datasets.
  3. If you do not utilise OS AddressBase datasets, please include the following data: Flat, BuildingName, BuildingNumber, StreetName, Town or PostTown, Postcode.

We suggest using commas as delimiters as shown in this example. Some data points may not exist for each particular address. In this case, simply ignore them.

Address format examples:

5 WOODBINE TERRACE, EXETER, EX4 4LJ
where 5 is BuildingNumber, WOODBINE TERRACE is StreetName, EXETER is Town, EX4 4LJ is Postcode.

FLAT 1, CHARLOTTE COURT, INVERMEAD CLOSE, LONDON, W6 0WW
where FLAT 1 is Flat, CHARLOTTE COURT is BuildingName, INVERMEAD CLOSE is StreetName, LONDON is Town, W6 0WW is Postcode.

Parameters

NameDescription
address
path
string
Should contain the complete address, ending with postcode. The parameter is case-insensitive.
api_key
query
enum

Your API key.

DEMO key allows you to test the method in the W6 0 postcode sector, or in the [[51.492, -0.25], [51.502, -0.225]] rectangle.

Request URL:
https://crystalroof.co.uk/customer-api/council-tax/address/v1/{address}?api_key=DEMO
Possible responses with examples
Code
Description
200
Success
400
Bad Request
401
Unauthorized
402
Payment Required
403
Forbidden
429
Too Many Requests
500
Internal Server Error