Sourcing owners
POST /v1/sourcing/ownersResolve registered owners for parcels returned by `sourcing_search`.
Same call over MCP
Owners of sourced parcelssourcing_ownersAuthenticate 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/owners returns
Uses the bulk HM Land Registry corporate and overseas ownership registers, so it names companies, public bodies and overseas entities. Individually owned titles are not in the bulk data and come back unresolved — that is a gap in the free register, not a failed lookup, and naming an individual requires a paid per-title purchase which this tool does not make.
UK only.
Inputs
Before you call it
- parcel_ids
- Parcel and land identifiers come from sourcing_search. Run the search first, then pass the identifiers of the parcels you want resolved or appraised.
Request
Calling POST /v1/sourcing/owners
curl -X POST "https://api.marketcode.ai/v1/sourcing/owners" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"
-H "Content-Type: application/json" \
-d '{"parcel_ids":"$parcel_ids"}'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 |
|---|---|---|---|---|
| asset | Body | string | No | One of: land, unitsDefault: land |
| parcel_ids | Body | string[] | Yes | Parcel ids from a sourcing_search result. |
Response
What POST /v1/sourcing/owners returns for a real request
curl -X POST "https://api.marketcode.ai/v1/sourcing/owners" \
-H "Authorization: Bearer $MARKETCODE_API_KEY"
-H "Content-Type: application/json" \
-d '{"parcel_ids":"$parcel_ids"}'{
"error": "unresolved argument",
"detail": "unresolved $parcel_ids"
}The call failed with these arguments; the status and message are shown rather than an invented body.
Price and licence
What it costs, and where the data comes from
Sourcing owners costs 5 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, from HM Land Registry and Companies House. A call that fails is not charged.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Sources
- HM Land Registry
Commercial and Corporate Ownership (CCOD) and Overseas Companies Ownership (OCOD)
HM Land Registry's dataset licence for CCOD and OCOD: free of charge, with conditions on onward use · England and Wales
- Companies House
Company register, officers and persons with significant control
Free to use under Companies House terms; Crown copyright · UK
Related
Endpoints used with Sourcing owners
- Search land or units by criteria8 credits
sourcing_searchFind land parcels or residential units matching investment criteria — the sourcing tool. Give a `location` (place or area name) or a `bbox`.Named in the description - Titles held by a company3 credits
ownership_by_companyTitles held by a company, by Companies House number. Useful for mapping aSame product - Proprietor profile5 credits
owner_profileWhat the Land Registry shows for one proprietor: titles held, company status, country of incorporation, directors and PSCs where known.Same product - Long-held, high-equity properties8 credits
long_held_high_equityLong-held properties in an area carrying a large paper gain — the classic off-market cohort, ordered by gain rather than by value.Same product - Distressed assets: repeatedly unsold lotsFree
distressed_assetsProperties that keep going to auction and NEVER SELL — the distress screen.Same product - Site appraisal dossier5 credits
site_appraisalEverything known about ONE site, assembled and judged — the site dossier.Same product
Glossary
Terms used here
- Registered proprietor: The person or entity HM Land Registry records as owning a title; for companies, public bodies and overseas entities MarketCode reads it from the bulk ownership registers.
- CCOD and OCOD: HM Land Registry's two bulk datasets of titles owned by UK companies and public bodies (CCOD) and by overseas companies (OCOD), the source of MarketCode's ownership answers.
FAQ
Questions about Sourcing owners
How much does `sourcing_owners` cost?
+
Sourcing owners costs 5 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, from HM Land Registry and Companies House. 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_owners 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?
+
Read from HM Land Registry ownership registers and Companies House company register, officers and persons with significant control. Coverage is the UK.
Can I store or republish the results?
+
The response includes records we license from HM Land Registry and Companies House. 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_owners` 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 owners on a real address.
30-minute call. We'll provision a key and walk through the endpoint on your use case.