HM Land Registry Official Copies API
Document information related to a title.
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-official-copies-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 Official Copies API
version: 1.0.0
description: 'Operations tagged Official Copies across 2 of this provider''s published API definitions: hm-land-registry-official-copy-document-availability-v1-openapi.json, hm-land-registry-official-copy-document-availability-v2-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://businessgateway.landregistry.gov.uk/bg2/api/v1
- url: https://businessgateway.landregistry.gov.uk/bg2/api/v2
security:
- basicAuth: []
tags:
- name: Official Copies
description: Document information related to a title.
paths:
/titles/{title_number}/official-copies/availability:
get:
operationId: getOfficialCopiesAvailability
tags:
- Official Copies
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'
examples:
'1: Title is valid and has the register immediately available':
value:
data:
title_status: Title number is valid.
title_status_code: VALID
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Title Plan
type_code: TITLEPLAN
availability: not available
availability_code: UNAVAILABLE
backdated: false
'2: Title is valid and does not have the register immediately available':
value:
data:
title_status: Title number is valid.
title_status_code: VALID
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: requires further investigation
availability_code: MANUAL
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: not available
availability_code: UNAVAILABLE
backdated: false
'3: Title is valid and has the title plan immediately available':
value:
data:
title_status: Title number is valid.
title_status_code: VALID
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: not available
availability_code: UNAVAILABLE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
'4: Title is valid and does not have the title plan immediately available':
value:
data:
title_status: Title number is valid.
title_status_code: VALID
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: not available
availability_code: UNAVAILABLE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: requires further investigation
availability_code: MANUAL
backdated: false
'5: Title is valid, has pending correction applications against it and has the register immediately available':
value:
data:
title_status: There is at least one pending application for registration against this title number. You may want to view the day list.
title_status_code: PENDING_APPLICATIONS
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: not available
availability_code: UNAVAILABLE
backdated: false
'6: Title is valid, has pending correction applications against it and does not have the register immediately available':
value:
data:
title_status: There is at least one pending application for registration against this title number. You may want to view the day list.
title_status_code: PENDING_APPLICATIONS
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: requires further investigation
availability_code: MANUAL
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: not available
availability_code: UNAVAILABLE
backdated: false
'7: Title is valid, has pending correction applications against it and has the title plan immediately available':
value:
data:
title_status: There is at least one pending application for registration against this title number. You may want to view the day list.
title_status_code: PENDING_APPLICATIONS
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: not available
availability_code: UNAVAILABLE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
'8: Title is valid, has pending correction applications against it and does not have the title plan immediately available':
value:
data:
title_status: There is at least one pending application for registration against this title number. You may want to view the day list.
title_status_code: PENDING_APPLICATIONS
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: not available
availability_code: UNAVAILABLE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: requires further investigation
availability_code: MANUAL
backdated: false
'9: Title is valid and has pending non-correction applications against it':
value:
data:
title_status: There is at least one pending application for registration against this title number. You may want to view the day list.
title_status_code: PENDING_APPLICATIONS
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: true
title_plan:
type: Plan
type_code: TITLEPLAN
availability: available for immediate download
availability_code: IMMEDIATE
backdated: true
'10: Title is valid and closed/cancelled':
value:
data:
title_status: According to our records this title number has been cancelled (or closed).
title_status_code: CLOSED
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: not available
availability_code: UNAVAILABLE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: not available
availability_code: UNAVAILABLE
backdated: false
'11: Title is valid, closed and continued under another title number':
value:
data:
title_status: The title number you entered, has been closed and continued under another title number.
title_status_code: CLOSED_AND_CONTINUED
title_number: AB000000
applications_pending: false
continued_under_title_number: AB000001
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: not available
availability_code: UNAVAILABLE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: not available
availability_code: UNAVAILABLE
backdated: false
'12: Title is valid but not computerised':
value:
data:
title_status: No computerised register held for this title. Please check the title number.
title_status_code: NOT_COMPUTERISED
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: not available
availability_code: UNAVAILABLE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: not available
availability_code: UNAVAILABLE
backdated: false
'13: Title is valid, is a pending new title or has pending dealings against it':
value:
data:
title_status: This is a pending new title number allocated for a dealing with the whole. Only document requests can be accepted against it.
title_status_code: PENDING_DEALING
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: not available
availability_code: UNAVAILABLE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: not available
availability_code: UNAVAILABLE
backdated: false
'14: Title is valid but is a scheme title':
value:
data:
title_status: This is a scheme title number allocated prior to receipt of the first application. Only document requests can be accepted against it.
title_status_code: SCHEME
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: not available
availability_code: UNAVAILABLE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability: not available
availability_code: UNAVAILABLE
backdated: false
'15: Title is valid and has register referred to documents':
value:
data:
title_status: Title number is valid.
title_status_code: VALID
title_number: AB000000
applications_pending: false
referred_to_documents:
- type: Abstract
type_code: ABSTRACT
entry_numbers:
- A1
date: '2020-12-01'
filed_under: AB000000
availability: available for immediate download
availability_code: IMMEDIATE
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'16: Title is valid and has no register referred to documents':
value:
data:
title_status: Title number is valid.
title_status_code: VALID
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'17: Title is valid, closed/cancelled and has register referred to documents':
value:
data:
title_status: According to our records this title number has been cancelled (or closed).
title_status_code: CLOSED
title_number: AB000000
applications_pending: false
referred_to_documents:
- type: Abstract
type_code: ABSTRACT
entry_numbers:
- A1
date: '2020-12-01'
filed_under: AB000000
availability: available for immediate download
availability_code: IMMEDIATE
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'18: Title is valid, closed/cancelled and has no register referred to documents':
value:
data:
title_status: According to our records this title number has been cancelled (or closed).
title_status_code: CLOSED
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'19: Title is valid, has pending non-correction applications against it and has register referred to documents':
value:
data:
title_status: There is at least one pending application for registration against this title number. You may want to view the day list.
title_status_code: PENDING_APPLICATIONS
title_number: AB000000
applications_pending: true
referred_to_documents:
- type: Charge
type_code: CHARGE
entry_numbers:
- A1
date: '2020-12-01'
filed_under: null
availability: available for immediate download
availability_code: IMMEDIATE
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'20: Title is valid, has pending non-correction applications against it and has no register referred to documents':
value:
data:
title_status: There is at least one pending application for registration against this title number. You may want to view the day list.
title_status_code: PENDING_APPLICATIONS
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'21: Title is valid, has pending correction applications against it and has register referred to documents':
value:
data:
title_status: There is at least one pending application for registration against this title number. You may want to view the day list.
title_status_code: PENDING_APPLICATIONS
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'22: Title is valid, has pending correction applications against it and has no register referred to documents':
value:
data:
title_status: There is at least one pending application for registration against this title number. You may want to view the day list.
title_status_code: PENDING_APPLICATIONS
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'23: Title is valid, is a scheme title and has register referred to documents':
value:
data:
title_status: This is a scheme title number allocated prior to receipt of the first application. Only document requests can be accepted against it.
title_status_code: SCHEME
title_number: AB000000
applications_pending: false
referred_to_documents:
- type: Abstract
type_code: ABSTRACT
entry_numbers:
- A1
date: '2020-12-01'
filed_under: AB000000
availability: available for immediate download
availability_code: IMMEDIATE
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'24: Title is valid, is a scheme title and has no register referred to documents':
value:
data:
title_status: This is a scheme title number allocated prior to receipt of the first application. Only document requests can be accepted against it.
title_status_code: SCHEME
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'25: Title is valid, closed and continued under another title number':
value:
data:
title_status: The title number you entered, has been closed and continued under another title number.
title_status_code: CLOSED_AND_CONTINUED
title_number: AB000000
applications_pending: false
continued_under_title_number: AB000001
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'26: Title is valid but not computerised':
value:
data:
title_status: No computerised register held for this title. Please check the title number.
title_status_code: NOT_COMPUTERISED
title_number: AB000000
applications_pending: false
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability_code: UNAVAILABLE
availability: not available
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'27: Title is valid, is a pending new title or has pending dealings against it':
value:
data:
title_status: This is a pending new title. A register or title plan is currently not available.
title_status_code: PENDING_FIRST
title_number: AB000000
applications_pending: true
referred_to_documents: []
register:
type: Register
type_code: REGISTER
availability: available for immediate download
availability_code: IMMEDIATE
backdated: false
title_plan:
type: Plan
type_code: TITLEPLAN
availability_code: UNAVAILABLE
availability: not available
backdated: false
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
'& 14: Title is invalid':
value:
errors:
- error_code: BG40001
error_message: Malformed invalid schema. Title is invalid.
http_status: '400'
timestamp: '2019-03-21T05:10:21+00:00'
trace_id: 66d62778-cab6-47d7-b067-ceb2a5efb013
'404':
description: Title not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
'& 14: Title is invalid':
value:
errors:
- error_code: BG40002
error_message: Title is not found
http_status: '404'
timestamp: '2018-11-13T20:20:39+00:00'
trace_id: eeb2e6aa-8856-4762-8d2f-f9ee6c0667bd
default:
$ref: '#/components/responses/DefaultErrorResponse'
servers:
- url: https://businessgateway.landregistry.gov.uk/bg2/api/v1
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 descri
# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hm-land-registry/refs/heads/main/openapi/hm-land-registry-official-copies-api-openapi.yml