---
title: "Obtain download link for an HMLR document"
method: GET
path: "/v1/documents/{document_id}"
tags: ["Download a document API"]
---

# Obtain download link for an HMLR document

`GET /v1/documents/{document_id}`

## Request

- Base URL: `https://businessgateway.landregistry.gov.uk/bg2/api`
- URL: `https://businessgateway.landregistry.gov.uk/bg2/api/v1/documents/{document_id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hm-land-registry/apis/v1-0-submit-an-application-to-change-the-land-register-api-s/docs/v1/documents/:document_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Request the download link for a document. Currently only supports the download of documents HMLR despatches, i.e correspondence, cancellation and completion documents.

## Path parameters

- `document_id` string, required

## Other responses

- `302`: Resource was successfully found.
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2025-11-07** `04719f6cbb9c`: 1 info
  - api operation id `Get Download URL` removed and replaced with `download_a_document_v1`
- **2025-10-31** `3a8f0dc06f13`: 1 info
  - the endpoint scheme security `basic_auth` was removed from the API
- **2025-10-14** `0091dc2b686d`: 1 info
  - api operation id `getDownloadUrlV1` removed and replaced with `Get Download URL`
- **2025-10-14** `401d6939103f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hm-land-registry/apis/v1-0-submit-an-application-to-change-the-land-register-api-s/changes/v1/documents/:document_id/get.md)

---

[API](https://skmtc.dev/hm-land-registry/apis/v1-0-submit-an-application-to-change-the-land-register-api-s.md) - [All operations](https://skmtc.dev/hm-land-registry/apis/v1-0-submit-an-application-to-change-the-land-register-api-s/llms.txt) - [OpenAPI document](https://skmtc.dev/hm-land-registry/apis/v1-0-submit-an-application-to-change-the-land-register-api-s/revisions/6964bf9fc289?raw)