Market commercial rent index
GET /v1/market/commercial-rent-indexCommercial RENT index from the VOA rating lists — FOUR points, one per list (2010 / 2017 / 2023 / 2026), each dated at that list's antecedent valuation date (2008-04-01, 2015-04-01, 2021-04-01, 2024-04-01), with the 2010 list = 100.
Same call over MCP
Commercial rent indexcommercial_rent_index_seriesAuthenticate with an API key from the API & MCP Hub. The same call is available as an MCP tool at the same price.
Reference
What GET /v1/market/commercial-rent-index returns
READ basis AND REPEAT IT when you quote a number: the index is derived from VOA rateable values — the Valuation Office Agency's assessment of open-market rent at each valuation date — NOT from advertised rents, and it is not a capital-value index. It moves in four steps; do not interpolate between them as if it were monthly, and date each point by avd_date, not list_year.
Why it exists: it covers the sectors the repeat-sales capital index cannot (INDUSTRIAL_WAREHOUSE trades in portfolios, not Price Paid), for every VOA sector and 320 local authorities.
sector: omit for ALL, or a VOA sector (OFFICE, RETAIL, INDUSTRIAL_WAREHOUSE, INDUSTRIAL_FACTORY, PUB_BAR, HOTEL, LEISURE, HEALTHCARE, EDUCATION, ...). area: omit for national; a local authority GSS code ("E08000003") or NAME ("Manchester", bridged to its code). start / end: rating-list years, e.g. "2017".
link_ratio is the median rateable-value ratio between consecutive lists over the hereditaments present in both (n_constant of them). An empty series with available_sectors means the area is published but not that sector; an unknown area is an error. UK only.
Inputs
Before you call it
- sector
- Sectors follow the VOA classification (OFFICE, RETAIL, INDUSTRIAL_WAREHOUSE, HOTEL and so on). Omit the argument for all sectors; the response names the sectors published for an area when the one you asked for is not.
Request
Calling GET /v1/market/commercial-rent-index
curl "https://api.marketcode.ai/v1/market/commercial-rent-index?sector=RETAIL&area=Manchester" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"Send your API key as a Bearer token. Every response carries credits_charged and credits_remaining.
Inputs
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| sector | Query | string | No | ALL (default) or a VOA sector, e.g. INDUSTRIAL_WAREHOUSE |
| area | Query | string | No | Omit for national; else a local authority GSS code or NAME |
| from | Query | string | No | First rating-list year, e.g. 2017 |
| to | Query | string | No | Last rating-list year (inclusive) |
Response
What GET /v1/market/commercial-rent-index returns for a real request
curl "https://api.marketcode.ai/v1/market/commercial-rent-index?sector=RETAIL&area=Manchester" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"{
"country": "UK",
"query": {
"sector": "RETAIL",
"area": "Manchester"
},
"data": {
"scope": "city",
"sector": "RETAIL",
"area": {
"area_key": "E08000003",
"area_name": "Manchester"
},
"basis": "Derived from VOA rateable values, not from advertised rents. A rateable value is the Valuation Office Agency's assessment of the open-market rent a hereditamen…",
"series": [
{
"list_year": 2010,
"avd_date": "2008-04-01",
"value": 100,
"link_ratio": null,
"n_constant": null
},
{
"list_year": 2017,
"avd_date": "2015-04-01",
"value": 103.537755527743,
"link_ratio": 1.03537755527743,
"n_constant": 5090
},
{
"list_year": 2023,
"avd_date": "2021-04-01",
"value": 118.0693703386543,
"link_ratio": 1.1403508771929824,
"n_constant": 5706
},
"… 1 more"
],
"provenance": {
"source_table": "marts_facts.commercial_rent_index",
"kind": "rent",
"method": "constant_sample_rv_ratio_chain",
"base": "2010 rating list (antecedent valuation date 2008-04-01) = 100",
"n_points": 4,
"rating_lists": [
{
"list_year": 2010,
"avd_date": "2008-04-01"
},
{
"list_year": 2017,
"avd_date": "2015-04-01"
},
{
"list_year": 2023,
"avd_date": "2021-04-01"
},
"… 1 more"
],
"built_at": "2026-08-31T21:41:13.003756",
"available_sectors": null
},
"notes": [],
"source": "robosapien",
"cached": true,
"time_ms": 0.4
},
"credits_charged": 0
}A real response, captured from production and trimmed: arrays to three items, long strings shortened, volatile keys dropped.
Response
Response fields
| Field | Type | Example |
|---|---|---|
| country | string | UK |
| query | object | |
| query.sector | string | RETAIL |
| query.area | string | Manchester |
| data | object | |
| data.scope | string | city |
| data.sector | string | RETAIL |
| data.area | object | |
| data.area.area_key | string | E08000003 |
| data.area.area_name | string | Manchester |
| data.basis | string | Derived from VOA rateable values, not from adver |
| data.series | array | |
| data.series[].list_year | integer | 2010 |
| data.series[].avd_date | string | 2008-04-01 |
| data.series[].value | integer | 100 |
| data.series[].link_ratio | null | |
| data.series[].n_constant | null | |
| data.provenance | object | |
| data.provenance.source_table | string | marts_facts.commercial_rent_index |
| data.provenance.kind | string | rent |
| data.provenance.method | string | constant_sample_rv_ratio_chain |
| data.provenance.base | string | 2010 rating list (antecedent valuation date 2008 |
| data.provenance.n_points | integer | 4 |
| data.provenance.rating_lists | array | |
| data.provenance.rating_lists[].list_year | integer | 2010 |
| data.provenance.rating_lists[].avd_date | string | 2008-04-01 |
| data.provenance.built_at | string | 2026-08-31T21:41:13.003756 |
| data.provenance.available_sectors | null | |
| data.notes | array | |
| data.source | string | robosapien |
| data.cached | boolean | true |
| data.time_ms | number | 0.4 |
| credits_charged | integer | 0 |
Fields observed in the example response above; a field the example did not exercise is not listed.
Price and licence
What it costs, and where the data comes from
Market commercial rent index is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Computed by MarketCode from
- Valuation Office Agency
Non-domestic rating lists (2010, 2017, 2023, 2026)
Crown copyright, published by the VOA · England and Wales
How the model or index is built, and where it is weak, is on the methodology page.
Related
Endpoints used with Market commercial rent index
- Asking-price index (portal listings)Free
asking_price_index_seriesHedonic ASKING-PRICE index for one postcode district, local authority or Great Britain, from portal listings (Rightmove ~95%), 2022M01 = 100, with 80% bands and posterior standard errors, smoothed toward the parent geography.Same category - Asking-rent index (portal listings, ONS-validated)Free
asking_rent_index_seriesHedonic ASKING-RENT index for one postcode district, local authority or Great Britain, from portal lettings, 2022M01 = 100, with bands and SEs. This is the residential rent index; commercial_rent_index_series is the VOA one for commercial property.Same category - Commercial capital indexFree
commercial_index_seriesRepeat-sales CAPITAL index for UK commercial property, quarterly, 1995Q1 = 100.Same category - Commercial capital and rent indices for a placeFree
commercial_marketThe commercial market for a sector and a place: the repeat-sales CAPITAL index, the VOA rating-list RENT index, and the rated stock standing in the authority with its hereditament count, total and median rateable value.Same category - Index forecast h1–h7 with bandsFree
market_forecastThe published house-price index forecast for a postcode district or local authority: the last SETTLED index point as the anchor, then up to seven forecast periods with `lo`/`hi` bands, plus the method and publication grain behind them. Seven is the horizon the index publishes — nothing beyond it is offered, and a forecast is a projection of the smoothed repeat-sales index, not a valuation of any property. UK only.Same category - House price index seriesFree
market_index_seriesThe published house-price INDEX for one postcode district or local authority: the level per month (base period = 100), the forecast tail flagged, and provenance saying how the index was built.Same category
Glossary
Terms used here
- GSS code: The nine-character statistical code the ONS gives every UK administrative area; MarketCode accepts names in most places and bridges them to codes internally.
- Rateable value and hereditament: The VOA's assessment of a non-domestic property's open-market annual rent at a fixed valuation date; the unit assessed is a hereditament, and the assessments form the rating list.
FAQ
Questions about Market commercial rent index
How much does `commercial_rent_index_series` cost?
+
Market commercial rent index is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
How do I authenticate?
+
Send your API key as a Bearer token in the Authorization header. Keys are created in the API & MCP Hub, shown once and revocable. Every response carries the credits charged and your remaining balance.
Is there an MCP version?
+
Yes. The commercial_rent_index_series tool on the MarketCode MCP server is the same call at the same price, signed in with OAuth rather than a key, so Claude, ChatGPT, Codex and Cursor can run it in a conversation.
Where does the data come from?
+
Computed by MarketCode from Valuation Office Agency rating lists. Coverage is the UK. The methodology page describes how the model or index is built.
Does `commercial_rent_index_series` change anything?
+
No. The tool is annotated read-only on the server, so it never writes to your data or ours and an assistant can call it without a confirmation step.
Try Market commercial rent index on a real address.
30-minute call. We'll provision a key and walk through the endpoint on your use case.