HM Land Registry Titles API
Operations regarding titles
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/hm-land-registry-titles-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: Hm Land Registry Titles API
version: 0.0.4
description: 'Operations tagged Titles across 2 of this provider''s published API definitions: hm-land-registry-official-copy-document-availability-v1-customer-test-openapi.json, hm-land-registry-official-copy-document-availability-v2-customer-test-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://bgtest.landregistry.gov.uk/bg2test/api/v1
description: Customer Test
- url: https://bgtest.landregistry.gov.uk/bg2test/api/v2
description: Customer Test
security:
- basicAuth: []
tags:
- name: Titles
description: Operations regarding titles
paths:
/titles/{title_number}/official-copies/availability:
get:
operationId: getOfficialCopiesAvailability
tags:
- Titles
summary: Get document availability associated with a title number.
description: Returns the OC1 document availability (title register and title plan) and a collection of OC2 document availability (referred to in the register) for the provided title number.
parameters:
- $ref: '#/components/parameters/TitleNumberParameter'
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
required:
- data
properties:
data:
$ref: '#/components/schemas/OfficialCopiesResponse'
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'404':
description: Title not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
default:
$ref: '#/components/responses/DefaultErrorResponse'
servers:
- url: https://bgtest.landregistry.gov.uk/bg2test/api/v1
description: Customer Test
components:
parameters:
TitleNumberParameter:
in: path
name: title_number
description: The title number of the property. Characters must be uppercase.
schema:
$ref: '#/components/schemas/TitleNumber'
required: true
schemas:
TitleNumber:
description: The title number of the property. Characters must be uppercase.
type: string
maxLength: 9
pattern: ^[A-Z0-9]{1,9}$
ErrorResponse:
description: A response for an unsuccesful result.
type: object
properties:
errors:
description: A collection of one or more errors as to why the API request failed.
type: array
items:
$ref: '#/components/schemas/Error'
Error:
type: object
description: An error response for an unsuccessful request.
required:
- error_code
- error_message
properties:
error_code:
type: string
description: The code related to this error. See documentation for more information.
error_message:
type: string
description: The descriptive reason behind an error.
http_status:
type: string
description: The http status code related to this error.
example: '503'
timestamp:
description: The UTC timestamp of when the error occurred.
type: string
format: date-time
example: 2021-04-04 15:29:51:405Z
trace_id:
description: A trace identifier for this request.
type: string
example: c62e9b3f-e523-4f04-a941-c6cf0d60c080
TitlePlanAvailability:
type: object
description: The availability of the official plan produced by HM Land Registry to show the extent of land in an individual registered title.
required:
- type_code
- type
- availability
- availability_code
- backdated
properties:
type:
type: string
type_code:
description: The document code for a title plan.
type: string
enum:
- TITLEPLAN
availability:
description: The document availability description.
type: string
availability_code:
$ref: '#/components/schemas/OfficialCopyAvailabilityCode'
backdated:
type: boolean
description: Whether or not the document will be backdated due to pending applications.
OfficialCopyAvailabilityCode:
description: The download availability states for a document.
type: string
enum:
- IMMEDIATE
- MANUAL
- UNAVAILABLE
ReferredDocumentAvailability:
description: The availability of an OC2 document referred to in the register.
type: object
required:
- type_code
- type
- entry_numbers
- filed_under
- availability
- availability_code
properties:
type:
type: string
description: Document type description.
type_code:
type: string
description: Document type code. See documentation *placeholder* for the list of type codes.
entry_numbers:
description: Where the document is referred to in the register.
type: array
items:
type: string
example:
- A1
- C3
- C4
date:
description: The date of the document.
type:
- string
- 'null'
format: date
filed_under:
description: The title number of the property. Characters must be uppercase.
type:
- string
- 'null'
maxLength: 9
pattern: ^[A-Z0-9]{1,9}$
availability:
description: The document availability description.
type: string
availability_code:
$ref: '#/components/schemas/OfficialCopyAvailabilityCode'
OfficialCopiesResponse:
type: object
description: A successful response.
required:
- title_status
- title_status_code
- title_number
- applications_pending
- referred_to_documents
- register
- title_plan
properties:
title_status:
type: string
description: The status of the title.
title_status_code:
type: string
enum:
- VALID
- CLOSED
- CLOSED_AND_CONTINUED
- NOT_COMPUTERISED
- PENDING_APPLICATIONS
- PENDING_DEALING
- PENDING_FIRST
- SCHEME
description: A code representing the current status of the title.
title_number:
$ref: '#/components/schemas/TitleNumber'
applications_pending:
description: Whether or not this title number has pending applications against it.
type: boolean
continued_under_title_number:
type: string
description: The title requested has been closed and continued under this title number.
example: FL99999
referred_to_documents:
type: array
description: The collection of OC2 documents referred to on the register.
items:
$ref: '#/components/schemas/ReferredDocumentAvailability'
register:
$ref: '#/components/schemas/RegisterAvailability'
title_plan:
$ref: '#/components/schemas/TitlePlanAvailability'
RegisterAvailability:
type: object
description: The availability of the record we create when registering titles to Land Registry.
required:
- type_code
- type
- availability
- availability_code
- backdated
properties:
type:
type: string
type_code:
description: The document code for a register.
type: string
enum:
- REGISTER
availability:
description: The document availability description.
type: string
availability_code:
$ref: '#/components/schemas/OfficialCopyAvailabilityCode'
backdated:
type: boolean
description: Whether or not the document will be backdated due to pending applications.
Source:
type: object
description: An object containing references to the primary source of the error.
properties:
pointer:
type: string
description: JSON Pointer to the value in the request document that caused the error.
parameter:
type: string
description: A string indicating which URI query parameter caused the error.
header:
type: string
description: A string indicating the name of a single request header which caused the error.
Error_2:
type: object
description: An error response for an unsuccessful request.
required:
- code
- detail
properties:
code:
type: string
description: The code related to this error. See documentation for more information.
detail:
type: string
description: The descriptive reason behind an error.
status:
type: string
description: The http status code related to this error.
example: '503'
trace_id:
description: A trace identifier for this request.
type: string
example: c62e9b3f-e523-4f04-a941-c6cf0d60c080
title:
type: string
description: A short summary of the problem that does not change from occurrence to occurrence of the problem.
source:
$ref: '#/components/schemas/Source'
ReferredDocumentAvailability_2:
description: The availability of an OC2 document referred to in the register.
type: object
required:
- type_code
- type
- entry_numbers
- filed_under
- availability
- availability_code
- plan_only
properties:
type:
type: string
description: Document type description.
type_code:
type: string
description: Document type code. See documentation *placeholder* for the list of type codes.
entry_numbers:
description: Where the document is referred to in the register.
type: array
items:
type: string
example:
- A1
- C3
- C4
date:
description: The date of the document.
type:
- string
- 'null'
format: date
filed_under:
description: The title number of the property. Characters must be uppercase.
type:
- string
- 'null'
maxLength: 9
pattern: ^[A-Z0-9]{1,9}$
availability:
description: The document availability description.
type: string
availability_code:
$ref: '#/components/schemas/OfficialCopyAvailabilityCode'
plan_only:
description: The document only contains a plan, not the complete document
type: boolean
responses:
DefaultErrorResponse:
description: An error has occurred.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
Gateway Timeout:
value:
errors:
- timestamp: '2018-11-13T20:20:39+00:00'
http_status: '504'
error_code: BG50004
error_message: Internal service timeout
securitySchemes:
basicAuth:
type: http
scheme: basic
x-refined-from:
- hm-land-registry-official-copy-document-availability-v1-customer-test-openapi.json
- hm-land-registry-official-copy-document-availability-v2-customer-test-openapi.json