HM Land Registry V0.3 ‘Submit an application to change the Land Register API’ Schema is one of 14 APIs that HM Land Registry publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes
6 operations
across 6 paths,
organized into 4 resource areas,
and defines 53 schemas.
It is described by OpenAPI 3.0.1, at version 0.3.
Requests are made against 2 base URLs: https://businessgateway.landregistry.gov.uk/bg2/api, https://bgtest.landregistry.gov.uk/bg2test/api.
6 operations6 paths53 schemas2 GET3 POST1 PUT
Metadata
The identity and technical contract details declared by the specification.
HM Land Registry V0.3 'Submit an application to change the Land Register API' Schema declares
1 security scheme
for authenticating requests.
It accepts HTTP basic authentication (basicAuth).
By default, every request must be authenticated.
Paths & Operations 6
Across 6 paths, the API surfaces 6 operations — 2 GET, 3 POST, 1 PUT. They span 4 resource areas: Submit an application API, Send a document API, Application information API, Notifications API. Each is listed below with its method, path, parameters, and response codes.
Submit an application API 1
POST
/v0/applications
Submit an application API - Submit application creation requests for processing
Submit an application API1 parambody→ 202400401500
Send a document API 2
POST
/v0/documents/url
Create an upload URL - Retrieve a generated document upload URL
Create an upload URLbody→ 200400401500
PUT
Upload a document
Upload a document - Upload the document contents. Note: This URL, including hostname and path parameters is returned from the create URL endpoint and should be used unmodified. The path and hostname…
The contract defines 53 schemas that model the data the API accepts and returns. The most detailed are SubstantiveApplicationData (13 properties), NotificationResponse (10 properties), Transaction (8 properties), ErrorResponse (7 properties). Each schema is shown below with its type and property counts.
AddressReference
string
Unique identifier for addresses, used to reference addresses from elsewhere in the spec
PartyReference
string
Unique identifier for parties, used to reference parties from elsewhere in the spec
DocumentReference
string
Unique identifier for documents, used to reference documents from elsewhere in the spec
TransactionReference
string
Unique identifier for transactions, used to reference transactions from elsewhere in the spec
TransactionFee
object
2 properties
AddressDetails
object
The details captured for a specific address. Details differ depending on type
1 property1 required
AddressForServiceOption
string
PROVIDEDADDRESS - The address for service has been provided alongside this option NOTREQUIRED - The address for service is not required for the party
AmountDetails
object
A type of TransactionDetails that captures the value of the transaction
BypassValidationData
object
Fields to describe which validators to bypass and why
4 properties4 required
Charge
object
A TransactionDetails object to capture information about a charge
2 required
Discharge
object
A TransactionDetails object to capture information about a discharge
1 required
DocumentMetadata
object
Metadata about the document that was uploaded
2 properties2 required
DocumentUploadUrlDataResponse
object
The response object containing information needed for uploading a document
1 property
DocumentUploadUrlResponse
object
The response object containing information needed for uploading a document
2 properties
DocumentUploadUrlData
object
The data needed to generate a URL to upload a document
4 properties3 required
DocumentUploadUrlRequest
object
The request to send to the endpoint to request an upload URL
1 property1 required
ErrorResponse
object
Wrapper for any error responses
7 properties
ProblemDetails
object
Detailed information about an error
3 properties2 required
ProblemDetail
object
6 properties1 required
ErrorDescription
object
4 properties1 required
ApplicationCreationDataResponse
object
The response wrapper from the application submission request
1 property
ApplicationCreationResponse
object
The response from the application submission endpoint
1 property
StatusDataResponse
object
Data wrapper for the status response
1 property
StatusResponse
object
The response object for the application status endpoint
7 properties
ApplicationLodger
object
Information about the person lodging the application (This is usually the conveyancer lodging on behalf of an individual)
3 properties2 required
OtherConveyancer
object
Information about another conveyancer (who is not the lodging conveyancer) representing a party on the application
3 properties3 required
SubstantiveApplicationData
object
The data required to capture an application
13 properties7 required
SubstantiveApplication
object
The request to submit an application to HM Land Registry
1 property1 required
TitleDetails
object
Information about a HM Land Registry title
4 properties4 required
TitleScopeDetails
object
The scope of the title that is being updated
2 properties1 required
TransactionDetails
object
Details of the transaction that apply to all transaction types
1 property1 required
Transfer
object
Details about a transfer transaction
4 required
ValueBand
object
A range the value of the transaction falls between. Valid bands are: 0 - 100000 100001 - 200000 200001 - 500000 500001 - 1000000 1000001 +
2 properties1 required
Address
object
An object containing an address, where the address details may be one of multiple types
1 property1 required
DocumentDetails
object
The details about an uploaded document
4 properties3 required
Party
object
A person or entity that has a role in an transaction
7 properties3 required
PartyRole
object
Information about the roles and capacities for a specific party
3 properties2 required
PrivateIndividual
object
A party object to capture infomation about a private individual
1 required
Transaction
object
The object representing a transaction to apply to specific titles on the application
8 properties3 required
UKCompany
object
A party object to capture infomation about an UK company
2 required
OverseasCompany
object
A party object to capture infomation about an overseas company
2 required
OtherOrganisation
object
A party object to capture infomation about an other organisation
1 required
UnknownParty
object
A party object to capture infomation about an unknown party
1 required
PartyDetails
object
Details of the party that apply to all party types
1 property1 required
BfpoAddress
object
A British Forces Post Office address
3 required
DxAddress
object
A document exchange address
2 required
EmailAddress
object
An object containing the email address of the customer
1 required
OverseasAddress
object
The address of a premise outside the UK
1 required
PoBoxAddress
object
An address of a PO Box
3 required
UkAddress
object
A UK postal address
3 required
NotificationResponse
object
10 properties
NotificationsLinks
object
2 properties
BulkAcknowledgeResult
object
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of HM Land Registry V0.3 'Submit an application to change the Land Register API' Schema, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
