---
title: "Request upload URL for your application attachments"
method: POST
path: "/v1/documents/url"
tags: ["Send a document API"]
---

# Request upload URL for your application attachments

`POST /v1/documents/url`

Create an upload URL - Retrieve a generated document upload URL

## Request body

- DocumentUploadUrlRequest — The request to send to the endpoint to request an upload URL
  - `data` DocumentUploadUrlData, required — The data needed to generate a URL to upload a document
    - `document_type` 'ABSTRACT' | 'ACKAPU' | 'ADJAR' | 'ADJREVU' | 'ADMIN_LTRS' | 'ADV1' | 'ADV2' | 'AGREEMENT' | 'AMS1' | 'AN1' | 'AP1' | 'APPL_FRM' | 'APPOINTMENT_OF_TRUSTEE' | 'AS1' | 'AS2' | 'AS3' | 'ASSENT' | 'ASSIGNMENT' | 'BIRTH_CERT' | 'BOUND_PLAN' | 'CC' | 'CCD' | 'CERT_CON_CH' | 'CERT_DEATH' | 'CERT_RED_EX' | 'CERT_REG_CH' | 'CERT_S89' | 'CH1' | 'CH2' | 'CH3' | 'CHARG_ORD' | 'CHARGE' | 'CIVIL_CERT' | 'CM2' | 'CM5' | 'CM6' | 'CN1' | 'CNFRM_DTMN_LTA_LGHA' | 'CNFRM_NO_DEED_SUR' | 'CNFRM_NO_LTA_LGHA' | 'CNSNT_ADMIN_COURT' | 'COMP_DOC' | 'CONSENT' | 'CONST_COMP' | 'CONTR_RES' | 'CONV_CERT' | 'CONV_CERT_DEATH' | 'CONVEYANCE' | 'COR_CERT' | 'CORRES' | 'COSR' | 'COURT_ORD' | 'CRALIQ' | 'CRED_DEC' | 'CRED_RES' | 'CRT_FORM_7' | 'CRWALIQ' | 'DB' | 'DEATH_CERT' | 'DEBENTURE' | 'DEC_AB_NULL_MARR' | 'DEED' | 'DEED_POLL' | 'DEED_REG_DIS' | 'DEED_SUR' | 'DISCHARGE' | 'DJP' | 'DL' | 'DOP' | 'DRIVING_LICENCE' | 'DS1' | 'DS2' | 'DS3' | 'DS3_SHORT' | 'EOB' | 'EOL' | 'EVD_NO_RENEW' | 'EVIDENCE' | 'EV_OV_NAME_CHANGE' | 'EX1' | 'EX1A' | 'EX3' | 'FORM_600' | 'FORM_600CH' | 'FORM_DI' | 'FORM_JO' | 'FR1' | 'GENDER_CERT' | 'GVD' | 'HR1' | 'HR2' | 'HR4' | 'ID1' | 'ID2' | 'ID3' | 'ID4' | 'ID5' | 'ID_EV' | 'ID_FRM' | 'INDENTURE' | 'JP1' | 'K17_OR_K18' | 'K20' | 'K22' | 'K3' | 'K4' | 'LEASE' | 'LICENCE' | 'LIQ_CERT_1' | 'LIQ_CERT_2' | 'LIQ_CERT_3' | 'LIQ01' | 'LNDLD_CNSNT' | 'LONP' | 'LR_CORRES' | 'LTT' | 'MARR_CERT' | 'MEMO' | 'MORD' | 'MRTG_DEED' | 'NOD' | 'ORD_DISS_NULL_CP' | 'PASSPORT' | 'PLAN' | 'POA' | 'PROBATE' | 'PSS1' | 'REVERS_INT' | 'RN' | 'RX1' | 'RX2' | 'RX3' | 'RX4' | 'RXC' | 'RXCD' | 'SC' | 'SDLT' | 'SEV' | 'SHRF_RTN' | 'SIDE_LTR' | 'SOT' | 'SSALIQ' | 'STAT_DEC' | 'SUB_CHARGE' | 'TP1' | 'TP2' | 'TR1' | 'TR2' | 'TR4' | 'TR5' | 'TRANSFER' | 'TRUSTEE_RESOLUTION' | 'UN1' | 'UN2' | 'UN3' | 'UN4' | 'UT1' | 'VAR_CHARGE' | 'VAR_COV' | 'VAR_EAS' | 'VAR_LEASE' | 'VESTING_ORDER' | 'WCT' | 'WINDING_UP' | 'WIT_STATE', required — The HM Land registry document type
    - `additional_provider_filter` string — A value that can be used to subsequently retrieve request responses based upon high level grouping
    - `file_length` integer, required — The file contents length in bytes
    - `file_sha256` string, required — The checksum of file contents, as a base64 encoded string of the SHA-256 binary digest of the file, which should be 44 characters long. See the Business Gateway developer pack for detailed information on generating the correct SHA-256 hash

## Response `200`

Request was successful

- DocumentUploadUrlDataResponse — The response object containing information needed for uploading a document
  - `data` DocumentUploadUrlResponse — The response object containing information needed for uploading a document
    - `upload_url` string — The URL used to upload the document. The request must be a PUT HTTP request, where the body of the request is the document that will be uploaded. This URL should only be used once
    - `document_id` string — A unique id for this document, which should be used in the application submission request

## Other responses

- `400` — Bad request
- `401` — Unauthorised - an access token is required
- `500` — Internal Server Error

---

[API](https://skmtc.net/hm-land-registry/apis/v1-0-submit-an-application-to-change-the-land-register-api-s.md) · [All operations](https://skmtc.net/hm-land-registry/apis/v1-0-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/v1-0-submit-an-application-to-change-the-land-register-api-s/revisions/6964bf9fc289/schema)