---
title: "POST /v0/applications"
method: POST
path: "/v0/applications"
tags: ["Submit an application API"]
---

# POST /v0/applications

`POST /v0/applications`

Submit an application API - Submit application creation requests for processing

## Headers

- `Idempotency-Key` string, required

## Request body

- SubstantiveApplication — The request to submit an application to HM Land Registry
  - `data` SubstantiveApplicationData, required — The data required to capture an application
    - `addresses` object — A map of address references to addresses
    - `submission_warning_understood` boolean, required — Setting this value to true notes you have understood the following: <br>**WARNING** <br>If you dishonestly enter information or make a statement that you know is, or might be, untrue or misleading, and intend by doing so to make a gain for yourself or another person, or to cause loss or the risk of loss to another person, you may commit the offence of fraud under section 1 of the Fraud Act 2006, the maximum penalty for which is 10 years’ imprisonment or an unlimited fine, or both. <br>Failure to complete this form with proper care may result in a loss of protection under the Land Registration Act 2002 if, as a result, a mistake is made in the register. <br>Under section 66 of the Land Registration Act 2002 most documents (including this form) kept by the registrar relating to an application to the registrar or referred to in the register are open to public inspection and copying. If you believe a document contains prejudicial information, you may apply for that part of the document to be made exempt using Form EX1, under rule 136 of the Land Registration Rules 2003
    - `applicants` PartyReference[], required — The party or parties who the application is being submitted for
    - `bypass_validation` BypassValidationData[] — A list of bypasses, for when a user disagrees with validation errors
      - `validation_type` string, required — The type of validation to bypass. Should match the 'type' returned within a status API error
      - `validation_pointer` string, required — A JSON pointer to the field in the submission payload to bypass the validation on. Should match the 'pointer' returned within a status API error
      - `reason` 'DISAGREE_WITH_REGISTER' | 'HMLR_DATA_INCORRECT_OR_OUTDATED' | 'EXCEPTION_NOT_COVERED_BY_BUSINESS_RULES', required — The reason the validation is being bypassed
      - `comment` string, required — A user inputted description of why the validation is being bypassed
    - `customer_reference` string, required — A short name/reference a customer has given to the application
    - `documents` object — A map of document references to documents
    - `jp1_reference` string — The JP1 reference to use when removing a JP1 restriction
    - `application_lodger` ApplicationLodger, required — Information about the person lodging the application (This is usually the conveyancer lodging on behalf of an individual)
      - `email` string, required — The email address of the application lodger
      - `telephone` string — A telephone number that can be used to contact the person lodging the application
      - `type` 'CONVEYANCER' | 'NON_CONVEYANCER', required — * `CONVEYANCER` - The user submitting the application is a conveyancer or acting on behalf of a conveyancer * `NON_CONVEYANCER` - The user submitting the application is not a conveyancer
    - `parties` object — A map of party references to parties
    - `titles` object, required — A map of title references to titles
    - `transactions` object, required — A map of title references to titles
    - `type` 'REGISTER_UPDATE' | 'TRANSFER_OF_PART' | 'DISPOSITIONARY_FIRST_LEASE' | 'REMOVE_JP1', required — The type of application to submit
    - `additional_provider_filter` string — A value that can be used to subsequently retrieve request responses based upon high level grouping

## Response `202`

Application creation request accepted

- ApplicationCreationDataResponse — The response wrapper from the application submission request
  - `data` ApplicationCreationResponse — The response from the application submission endpoint
    - `application_request_id` string — The ID of the application submission request

## Other responses

- `400` — Bad Request due to payload not meeting the required schema
- `401` — Unauthorised - an access token is required
- `500` — Internal Server Error

---

[API](https://skmtc.net/hm-land-registry/apis/v0-3-submit-an-application-to-change-the-land-register-api-s.md) · [All operations](https://skmtc.net/hm-land-registry/apis/v0-3-submit-an-application-to-change-the-land-register-api-s/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hm-land-registry/v0-3-submit-an-application-to-change-the-land-register-api-s/revisions/66ddff5586eb/schema)