Sourcing commercial
POST /v1/sourcing/commercialRated commercial stock in a local authority, filtered by sector and rateable value — the commercial sourcing lane. Each row carries its rateable value, an income-basis value, the freeholder where a title links, and any auction history.
Same call over MCP
Rated commercial stock in an authoritysourcing_commercialAuthenticate with an API key from the API & MCP Hub. The same call is available as an MCP tool at the same price.
Reference
What POST /v1/sourcing/commercial returns
NO £/m² IS PUBLISHED and you should not compute one. The VOA's measured area is not loaded, and dividing a hereditament-level rateable value by the twin's unit-level floor area gives nonsense — it produced £235,301/m² on a Westminster office before it was removed.
lad_code is REQUIRED and is the only scope: this is the one indexed way into the twin for a bounded set of hereditaments. Use area_resolve to turn a place name into a GSS code.
RATEABLE VALUE IS NOT RENT. It is the VOA's estimate of annual rental value at the rating list's antecedent valuation date (1 April 2024 for the 2026 list). Do not quote it as passing rent or as income.
income_basis_value divides that RV by the district's own commercial auction yield, so it is an arithmetic conversion anchored to local evidence, not a valuation — and it reads not_available where the district has no auction yield evidence, because a default yield would produce a number that looks like a valuation. Report the yield and the number of lots behind it.
One rating list is loaded (2026), so there is no RV trajectory per property, no measured floor area from the VOA, and no vacancy signal. UK only.
Request
Calling POST /v1/sourcing/commercial
curl -X POST "https://api.marketcode.ai/v1/sourcing/commercial" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"
-H "Content-Type: application/json" \
-d '{"lad_code":"<lad_code>"}'Send your API key as a Bearer token. Every response carries credits_charged and credits_remaining.
Inputs
Parameters
This endpoint takes no path or query parameters.
Request body
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| lad_code | Body | string | Yes | LAD GSS code, e.g. E09000032. Required. |
| sectors | Body | string[] | No | VOA sectors, e.g. ['RETAIL','OFFICE'] |
| scat_codes | Body | string[] | No | |
| min_rv | Body | integer | No | |
| max_rv | Body | integer | No | |
| with_owner | Body | boolean | No | Default: false |
| single_hereditament | Body | boolean | No | Default: false |
| limit | Body | integer | No | Default: 50 |
| offset | Body | integer | No | Default: 0 |
Price and licence
What it costs, and where the data comes from
Sourcing commercial costs 2 credits per successful call over MCP and over REST, and the two surfaces share one credit balance.
The price covers licensed records in the response. A call that fails is not charged.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Related
Endpoints used with Sourcing commercial
- Resolve an area nameFree
area_resolveResolve an area name or code ("Hackney", "E5") to its area_id, centroidNamed in the description - Build cost: index, regional factor, estimateFree
build_costBuild cost for a scheme: the sector's cost index with its 1- and 5-year movement, the regional location factor (`region`: NATIONAL, LONDON, SOUTH_EAST — an error lists what is loaded), the editorial on-cost percentages (prelims, contingency, overheads & profit, professional fees) and, given `gia_m2` and `rate_gbp_m2` (your BCIS or in-house base rate, with `rate_period` in the series' own format, e.g. 2024Q1), an estimate: the rate carried through the index to the latest period, localised, multiplied out, with totals at low / mid / high on-costs. The £/m² benchmark leg says `not_available` until a tender benchmark is loaded — no rate is invented, and nothing here is a modelled number. UK only.Same category - Construction cost index seriesFree
cost_indexConstruction cost index series for a development appraisal's cost side: `basis` is tender (tender price indices), output (output price indices), deflator (the construction deflator) or labour. Optional `sector` (residential, commercial, industrial, infrastructure, all, …), `freq` (monthly | quarterly | annual) and an inclusive period window in the series' own format (2014Q1, 2014M01, 2014). Each series carries its base period and method. UK-wide; regional factors come with the site appraisal. UK only.Same category - Adjacent parcels, owners and the combined site2 credits
land_assemblyThe parcels adjacent to one parcel and who owns each — the first question of a site assembly. Returns each neighbour with its area, land use, constraints and registered proprietor, plus a `combined` block: total area in m² and hectares, the number of distinct owners, how many neighbours already share the subject's proprietor (the parcels needing no second negotiation), how many have no linked owner, and every constraint present across the whole assembly.Same category - One parcel: owner, units, plot, constraints1 credit
parcel_lookupOne land parcel in full: its INSPIRE id, title number and OS id, area and land use, the registered proprietor where a title links, the units standing on it, plot utilisation, and every constraint flag.Same category - Site appraisal dossier5 credits
site_appraisalEverything known about ONE site, assembled and judged — the site dossier.Same category
FAQ
Questions about Sourcing commercial
How much does `sourcing_commercial` cost?
+
Sourcing commercial costs 2 credits per successful call over MCP and over REST, and the two surfaces share one credit balance. The price covers licensed records in the response. A call that fails is not charged.
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 sourcing_commercial 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?
+
The answer is computed by MarketCode. Coverage is the UK.
Can I store or republish the results?
+
The response includes records we license. Use them in your own analysis, reports and products; bulk redistribution of the raw records or building a competing dataset from them is not covered. Ask us if you need a redistribution licence.
Does `sourcing_commercial` 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 Sourcing commercial on a real address.
30-minute call. We'll provision a key and walk through the endpoint on your use case.