canonical: https://jentic.com/apis/landregistry.gov.uk/landregistry # Landregistry Deed API The HM Land Registry Deed API supports the digital mortgage deed workflow used to register a deed against a property in England and Wales. It exposes operations to create a new deed payload and to retrieve a deed by its reference, returning the structured deed document for downstream signing and registration. The API is part of the Land Registry digital mortgage service and was developed under the Digital Mortgage programme. ## For AI agents Create and retrieve digital mortgage deeds with HM Land Registry's Deed API to support property registration workflows. ## Scope Does not handle title register searches, property valuations, or stamp duty calculations - use for digital mortgage deed creation and retrieval only. ## Capabilities - Submit a new digital mortgage deed payload for registration with HM Land Registry - Retrieve a deed document by its reference for review or downstream signing - Extract the structured deed contents for storage in a property workflow system - Validate deed payload contents against the schema before submission - Track a deed by reference across the digital mortgage process ## Use cases ### Digital Mortgage Deed Submission A conveyancing platform creates a digital mortgage deed by posting the structured payload to the Deed API, receiving a deed reference that the borrower and lender can later sign. This replaces the paper deed step in the property purchase or remortgage workflow and ties into HM Land Registry's wider digital registration process. Example prompt: POST a deed payload containing borrower, lender, charge, and property details to /deed/ and store the returned deed reference for the e-signature step. ### Deed Retrieval for Review A solicitor's case management tool fetches an existing deed by reference to display its contents to the client before signing or to attach the document to a case file. The Deed API returns the structured deed payload, which the application can render in a human-readable form. Useful for audit, review, and reconciliation tasks. Example prompt: GET `/deed/{deed_reference}` for the supplied reference and surface the borrower, lender, and property fields for client review. ### AI Agent Conveyancing Assistant An AI agent embedded in a conveyancing workflow uses the Deed API through Jentic to draft and submit a digital mortgage deed, then retrieve it for signing. The agent searches Jentic for deed submission, loads the schema, and executes the call without manually wiring HM Land Registry endpoints. This shortens the time from instruction to signing-ready deed. Example prompt: Use Jentic to submit a new deed for property TT12345 with the supplied borrower and lender details, then immediately GET the deed by the returned reference to confirm the payload. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/deed/` | Create a new digital mortgage deed payload. | | GET | `/deed/{deed_reference}` | Retrieve a deed by its reference. | ## Key resources - **Deed** — Create a new digital mortgage deed and retrieve an existing deed by reference. ## Why Jentic - **Setup:** Wiring the HM Land Registry Deed API by hand means targeting the api.landregistry.gov.uk host and handling the digital mortgage deed lifecycle yourself. Through Jentic you install once, import the Deed API from the API Directory, store any service credential once, and your agent calls it. - **Permission scoping:** You choose which Deed operations the agent may call, so you can limit it to the ones it needs, such as creating a digital mortgage deed and retrieving one by reference. Granting retrieval alone lets the agent read a deed without being able to create new ones. - **Credential handling:** Any credential issued for the HM Land Registry digital mortgage service is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'create a digital mortgage deed' or 'retrieve a deed by reference', and Jentic returns the matching Deed API operation with its input schema so the agent calls the right endpoint without browsing the HM Land Registry docs. ## Related APIs - **GOV.UK API** — GOV.UK exposes content and notification services that pair with HM Land Registry workflows. - **PandaDoc** — PandaDoc handles document signing flows that can capture borrower and lender signatures on a generated deed. - **SignRequest** — SignRequest provides simple e-signature flows that complement the Deed API's document creation step. ## FAQ ### What authentication does the Deed API use? The published OpenAPI spec does not declare a security scheme. In practice the digital mortgage service is restricted to authorised conveyancers and lenders; access is arranged with HM Land Registry rather than self-service. Through Jentic, any credentials configured for the API are stored encrypted in the vault and never enter the agent context. ### Can I create a digital mortgage deed with the Deed API? Yes. POST /deed/ accepts a structured deed payload and returns a deed reference that downstream signing and registration steps use to identify the deed. ### Can I retrieve an existing deed with the Deed API? Yes. GET `/deed/{deed_reference}` returns the structured deed document for the supplied reference, which clients can render for review or attach to a case file. ### What are the rate limits for the Deed API? The spec does not enumerate rate limits. As an HM Land Registry service, throughput expectations are governed by the digital mortgage onboarding agreement; check with Land Registry directly for production limits. ### How do I submit a deed through Jentic? Search Jentic for 'create a digital mortgage deed', load the operation schema, and POST the payload to `/deed/.` Capture the returned deed_reference for the signing step. ### Is the Deed API free to use? There is no per-call fee in the spec; access is governed by HM Land Registry's digital mortgage service agreements rather than a public pricing tier. ### Can I limit what my agent is allowed to do with the Deed API? Yes. Jentic One is self-hosted by you, so your own rules decide which Deed operations and credentials the agent may use. You can allow only the operations it needs, such as retrieving a deed by reference with GET `/deed/{deed_reference}` while withholding the ability to create new deeds with POST `/deed/.` Granting retrieval alone lets the agent read a deed without being able to submit a new digital mortgage deed.