---
title: "Get document availability associated with a title number."
method: GET
path: "/titles/{title_number}/official-copies/availability"
tags: ["Official Copies"]
---

# Get document availability associated with a title number.

`GET /titles/{title_number}/official-copies/availability`

## Request

- Base URL: `https://businessgateway.landregistry.gov.uk/bg2/api/v1`
- URL: `https://businessgateway.landregistry.gov.uk/bg2/api/v1/titles/{title_number}/official-copies/availability`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hm-land-registry/apis/official-copy-document-availability-service/docs/titles/:title_number/official-copies/availability/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the OC1 document availability (title register and title plan) and a collection of OC2 document availability (referred to in the register) for the provided title number.

## Path parameters

- `title_number` string, required: The title number of the property. Characters must be uppercase.

## Response `200`

Success

- object
  - `data` OfficialCopiesResponse, required: A successful response.
    - `title_status` string, required: The status of the title.
    - `title_status_code` 'VALID' | 'CLOSED' | 'CLOSED_AND_CONTINUED' | 'NOT_COMPUTERISED' | 'PENDING_APPLICATIONS' | 'PENDING_DEALING' | 'PENDING_FIRST' | 'SCHEME', required: A code representing the current status of the title.
    - `title_number` string, required: The title number of the property. Characters must be uppercase.
    - `applications_pending` boolean, required: Whether or not this title number has pending applications against it.
    - `continued_under_title_number` string: The title requested has been closed and continued under this title number.
    - `referred_to_documents` ReferredDocumentAvailability[], required: The collection of OC2 documents referred to on the register.
      - `type` string, required: Document type description.
      - `type_code` string, required: Document type code.
      - `entry_numbers` string[], required: The location that the document is referred to in the register.
      - `date` string, date, nullable: The date of the document.
      - `filed_under` string, nullable, required: The title number of the property. Characters must be uppercase.
      - `availability` string, required: The document availability description.
      - `availability_code` 'IMMEDIATE' | 'MANUAL' | 'UNAVAILABLE', required: The download availability states for a document.
    - `register` RegisterAvailability, required: The availability of the record we create when registering titles to Land Registry.
      - `type` string, required
      - `type_code` 'REGISTER', required: The document code for a register.
      - `availability` string, required: The document availability description.
      - `availability_code` 'IMMEDIATE' | 'MANUAL' | 'UNAVAILABLE', required: The download availability states for a document.
      - `backdated` boolean, required: Whether or not the document will be backdated due to pending applications.
    - `title_plan` TitlePlanAvailability, required: The availability of the official plan produced by HM Land Registry to show the extent of land in an individual registered title.
      - `type` string, required
      - `type_code` 'TITLEPLAN', required: The document code for a title plan.
      - `availability` string, required: The document availability description.
      - `availability_code` 'IMMEDIATE' | 'MANUAL' | 'UNAVAILABLE', required: The download availability states for a document.
      - `backdated` boolean, required: Whether or not the document will be backdated due to pending applications.

## Other responses

- `400`: Invalid request
- `404`: Title not found
- `default`: An error has occurred.

---

[API](https://skmtc.dev/hm-land-registry/apis/official-copy-document-availability-service.md) - [All operations](https://skmtc.dev/hm-land-registry/apis/official-copy-document-availability-service/llms.txt) - [OpenAPI document](https://skmtc.dev/hm-land-registry/apis/official-copy-document-availability-service/revisions/399740497008?raw)
