Property API Reference — GovData Docs

UK House Price Index

Search monthly HPI records

Returns paginated monthly UK HPI measures for housing analysts, lenders, property products, and local publishers. Chart London flat-price movements, benchmark a regional valuation against the headline index, or compare cash and mortgage buyer trends over a chosen period.

GET /v1/property/hpi

Parameters

Name	Type	Required	Default	Description
`region`	string	No	—	Case-insensitive region name or exact official area code from /hpi/regions.
`from`	date	No	—	Inclusive start month in YYYY-MM-DD format.
`to`	date	No	—	Inclusive end month in YYYY-MM-DD format.
`page`	integer	No	1	One-based result page.
`per_page`	integer	No	25	Results per page; minimum 1, maximum 100.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.govdata.dev/v1/property/hpi?region=London&from=2026-05-01&to=2026-05-01&per_page=5"

Response

{
  "data": [
    {
      "date": "2026-05-01",
      "region": {
        "code": "E12000007",
        "name": "London"
      },
      "average_price": 544814.0,
      "index": 95.4,
      "index_sa": 96.5,
      "monthly_change": -1.2,
      "annual_change": -3.7,
      "average_price_sa": 550796.0,
      "sales_volume": null,
      "detached": {
        "price": 1138974.0,
        "index": 96.8,
        "monthly_change": -1.6,
        "annual_change": -2.3
      },
      "semi_detached": {
        "price": 716038.0,
        "index": 100.1,
        "monthly_change": -0.3,
        "annual_change": 0.4
      },
      "terraced": {
        "price": 631396.0,
        "index": 99.9,
        "monthly_change": -0.7,
        "annual_change": -0.6
      },
      "flat": {
        "price": 422576.0,
        "index": 91.6,
        "monthly_change": -1.7,
        "annual_change": -6.6
      },
      "cash": {
        "price": 575650.0,
        "index": 92.6,
        "monthly_change": -1.8,
        "annual_change": -6.4,
        "sales_volume": null
      },
      "mortgage": {
        "price": 538729.0,
        "index": 96.3,
        "monthly_change": -1.1,
        "annual_change": -2.9,
        "sales_volume": null
      },
      "ftb": {
        "price": 465145.0,
        "index": 95.0,
        "monthly_change": -1.1,
        "annual_change": -3.7
      },
      "foo": {
        "price": 683412.0,
        "index": 96.3,
        "monthly_change": -1.4,
        "annual_change": -3.5
      },
      "new_build": {
        "price": null,
        "index": null,
        "monthly_change": null,
        "annual_change": null,
        "sales_volume": null
      },
      "old": {
        "price": null,
        "index": null,
        "monthly_change": null,
        "annual_change": null,
        "sales_volume": null
      }
    }
  ],
  "meta": {
    "api_version": "v1",
    "licence": "Open Government Licence v3.0",
    "source": "UK House Price Index",
    "source_url": "https://publicdata.landregistry.gov.uk/market-trend-data/house-price-index-data/UK-HPI-full-file-2026-05.csv"
  },
  "pagination": {
    "total": 1,
    "page": 1,
    "per_page": 5,
    "total_pages": 1
  }
}

Prices are pounds, while index and change fields are numeric index points and percentages from the source. ftb means first-time buyer and foo means former owner occupier. Null prices or volumes mean the published HPI row did not supply that breakdown. The London row is from the bundled May 2026 development fixture.

Error responses

400 — either date is malformed. Valid filters with no records return an empty 200 response; there are no endpoint-specific 404 or 422 branches.

{"error":{"code":"invalid_parameter","message":"Invalid date format. Use YYYY-MM-DD.","documentation_url":"https://docs.govdata.dev/errors/invalid_parameter"}}

List HPI regions

Returns the official area-code and region-name pairs available to the HPI search. Use it to populate a region selector or translate a stored Land Registry area code before requesting a time series.

GET /v1/property/hpi/regions

Parameters

Name	Type	Required	Default	Description

This endpoint has no path, query, or pagination parameters.

curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.govdata.dev/v1/property/hpi/regions"

Response

{
  "data": [
    {
      "code": "E92000001",
      "name": "England"
    },
    {
      "code": "E12000007",
      "name": "London"
    },
    {
      "code": "K02000001",
      "name": "United Kingdom"
    }
  ],
  "meta": {
    "api_version": "v1",
    "licence": "Open Government Licence v3.0",
    "source": "UK House Price Index",
    "source_url": "https://publicdata.landregistry.gov.uk/market-trend-data/house-price-index-data/UK-HPI-full-file-2026-05.csv"
  }
}

The list reflects loaded records, not a fixed geography catalogue; fixture-seeded development contains three regions.

Error responses

There are no endpoint-specific 400, 404, or 422 responses because this endpoint accepts no parameters.

HPI data notes

Coverage and cadence: UK HPI national and regional series run from April 1968; local-authority series run from 1995. The regions endpoint covers approximately 405 regions in production (the example response uses the smaller development fixture set). Land Registry publishes monthly, provisionally, with roughly a two-month lag; recent months are revised as more transactions arrive.

Licence and attribution: source UK House Price Index from HM Land Registry and partner administrations, reused under the Open Government Licence v3.0. Attribute UK HPI and link to the official reports.

Mix-adjusted average prices are statistical estimates, not valuations of a typical individual home. Small-area and property-type series can be volatile or suppressed; seasonally adjusted fields are not available for every geography.

Council Tax by Authority and Band

Returns paginated annual Band A–H council-tax amounts for England, for household budgeting, relocation tools, and property platforms. Look up the full Band D charge for one billing authority or compare a band across authorities for a financial year.

GET /v1/property/council-tax

Parameters

Name	Type	Required	Default	Description
`authority_code`	string	No	—	Exact ONS billing-authority code.
`authority_name`	string	No	—	Case-insensitive partial authority-name match.
`band`	string	No	—	Valuation band A–H; matching is case-insensitive.
`financial_year`	string	No	—	Financial year in YYYY-YY format.
`page`	integer	No	1	One-based result page.
`per_page`	integer	No	25	Results per page; minimum 1, maximum 100.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.govdata.dev/v1/property/council-tax?authority_code=E09000007&band=D&financial_year=2026-27&per_page=5"

Response

{
  "data": [
    {
      "authority_code": "E09000007",
      "authority_name": "Camden",
      "financial_year": "2026-27",
      "band": "D",
      "amount": 2207.55
    }
  ],
  "meta": {
    "api_version": "v1",
    "licence": "Open Government Licence v3.0",
    "source": "MHCLG",
    "source_url": "https://assets.publishing.service.gov.uk/media/69de1fa63e81003ae0422508/Tables_1-9_2026-27.ods"
  },
  "pagination": {
    "total": 1,
    "page": 1,
    "per_page": 5,
    "total_pages": 1
  }
}

amount is the annual full-area charge in pounds for a two-adult household before discounts, including major, parish, and adult-social-care precepts. Code E09000007 is Camden in the seeded 2026–27 MHCLG data.

Error responses

There are no endpoint-specific 400, 404, or 422 branches. Unknown authorities, years, or bands return an empty data array with HTTP 200.

Council-tax data notes

Coverage and cadence: billing authorities in England only; current coverage is financial year 2026–27. MHCLG publishes the annual table once each financial year. Wales and Scotland publish separate datasets and Northern Ireland uses domestic rates.

Licence and attribution: source MHCLG Council Tax levels set by local authorities, reused under the Open Government Licence v3.0. Attribute MHCLG and the billing authority.

Amounts exclude household-specific discounts, exemptions, reductions, and premiums. A property's band is assigned by the Valuation Office Agency and is not derivable from this endpoint.

Search Transactions

GET /v1/property/price-paid/search

Search property transactions by postcode, town, or district. At least one location parameter is required.

Query parameters

Parameter	Type	Required	Description
`postcode`	string	No*	Full or partial postcode (e.g. `SW1A 1AA` or `SW1A`)
`town`	string	No*	Town or city name
`district`	string	No*	Local authority district
`property_type`	string	No	`detached`, `semi_detached`, `terraced`, `flat`
`page`	integer	No	Page number (default 1, 25 results per page)

* At least one of postcode, town, or district is required.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.govdata.dev/v1/property/price-paid/search?postcode=SW1A+1AA"

Response

{
  "data": {
    "transactions": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "price": 1250000,
        "date": "2024-11-15",
        "postcode": "SW1A 1AA",
        "property_type": "flat",
        "new_build": false,
        "tenure": "leasehold",
        "address": "FLAT 3, 12 DOWNING STREET, LONDON"
      }
    ],
    "pagination": { "page": 1, "per_page": 25, "total": 1 }
  },
  "meta": {
    "api_version": "v1",
    "licence": "Open Government Licence v3.0",
    "source": "HM Land Registry",
    "source_url": "https://www.gov.uk/government/collections/price-paid-data"
  }
}

Address Search

GET /v1/property/price-paid/address

Search property transactions by street address. Returns the sale history for a specific property or all transactions on a street.

Query parameters

Parameter	Type	Required	Description
`street`	string	Yes	Street name (e.g. `BIDSTON ROAD`)
`number`	string	No	House number or name (e.g. `36` or `THE OLD RECTORY`)
`postcode`	string	No	UK postcode to narrow results
`town`	string	No	Town or city name
`from`	string	No	Start date in `YYYY-MM-DD` format
`to`	string	No	End date in `YYYY-MM-DD` format
`page`	integer	No	Page number (default 1, 25 results per page)

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.govdata.dev/v1/property/price-paid/address?street=BIDSTON+ROAD&number=36"

Response

{
  "data": {
    "transactions": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "price": 185000,
        "date": "2022-06-10",
        "postcode": "CH43 2JZ",
        "property_type": "semi_detached",
        "new_build": false,
        "tenure": "freehold",
        "address": "36 BIDSTON ROAD, BIRKENHEAD"
      }
    ],
    "pagination": { "page": 1, "per_page": 25, "total": 1 }
  },
  "meta": {
    "api_version": "v1",
    "licence": "Open Government Licence v3.0",
    "source": "HM Land Registry",
    "source_url": "https://www.gov.uk/government/collections/price-paid-data"
  }
}

Get Transaction

GET /v1/property/price-paid/:id

Retrieve a single price paid transaction by its UUID.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.govdata.dev/v1/property/price-paid/a1b2c3d4-e5f6-7890-abcd-ef1234567890

Response

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "price": 1250000,
    "date": "2024-11-15",
    "postcode": "SW1A 1AA",
    "property_type": "flat",
    "new_build": false,
    "tenure": "leasehold",
    "estate_type": "flat",
    "address": "FLAT 3, 12 DOWNING STREET, LONDON",
    "town": "LONDON",
    "district": "CITY OF WESTMINSTER",
    "county": "GREATER LONDON"
  },
  "meta": {
    "api_version": "v1",
    "licence": "Open Government Licence v3.0",
    "source": "HM Land Registry",
    "source_url": "https://www.gov.uk/government/collections/price-paid-data"
  }
}

Statistics

GET /v1/property/price-paid/statistics

Aggregate statistics (average, median, min, max) with breakdown by property type for a given area.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.govdata.dev/v1/property/price-paid/statistics?postcode=SW1A"

Response

{
  "data": {
    "area": "SW1A",
    "transaction_count": 342,
    "overall": {
      "average": 2145000,
      "median": 1875000,
      "min": 285000,
      "max": 18500000
    },
    "by_type": {
      "flat": { "average": 1650000, "median": 1200000, "count": 256 },
      "terraced": { "average": 3200000, "median": 2900000, "count": 52 },
      "detached": { "average": 8750000, "median": 7500000, "count": 12 },
      "semi_detached": { "average": 4100000, "median": 3800000, "count": 22 }
    }
  },
  "meta": {
    "api_version": "v1",
    "licence": "Open Government Licence v3.0",
    "source": "HM Land Registry",
    "source_url": "https://www.gov.uk/government/collections/price-paid-data"
  }
}

Data Coverage

Source	HM Land Registry Price Paid Data; MHCLG Council Tax Levels
Date range	Transactions: 1995–present. HPI: national and regional series from April 1968; local-authority series from 1995.
Records	~31M transactions
Updated	Monthly
Limitations	Price paid covers England and Wales. Council tax covers England only, 2026-27; prior years are a follow-up.