---
title: "Property"
url: "https://developer.pexa.co.uk/apis/instruction-v1-v1/versions/861f183b-600d-4bbf-9762-abebcbf9b5ac/schemas/Property"
---

> Full API specification: https://developer.pexa.co.uk/apis/instruction-v1-v1/versions/861f183b-600d-4bbf-9762-abebcbf9b5ac.md

# Property

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Lender Instruction
  version: v1
servers:
  - url: https://api.pexa.co.uk
    description: API Gateway URL
components:
  schemas:
    Property:
      type: object
      required:
        - address
        - jurisdiction
      properties:
        jurisdiction:
          type: string
          pattern: ^(ENGLAND_WALES|SCOTLAND|NORTHERN_IRELAND)$
          description: >
            The jurisdiction of the property (REQUIRED field as of v1.1.0)
            Allowed values: [`ENGLAND_WALES`, `SCOTLAND`, `NORTHERN_IRELAND`]
        country:
          type: string
          pattern: ^(ENGLAND|WALES|SCOTLAND|NORTHERN_IRELAND)$
          description: >
            The country where the property is located Allowed values:
            [`ENGLAND`, `WALES`, `SCOTLAND`, `NORTHERN_IRELAND`]
        address:
          type: object
          required:
            - postcode
          properties:
            flat:
              type: string
              description: Flat/apartment number
            name:
              type: string
              description: Building name
            number:
              type: string
              description: House/building number
            street:
              type: string
              description: Street name
            town:
              type: string
              description: Town/city
            postcode:
              maxLength: 8
              minLength: 6
              type: string
              example: M16 0RA
              pattern: ^(([Gg][Ii][Rr]
                0[Aa]{2})|((([A-Za-z][0-9]{1,2})|(([A-Za-z][A-Ha-hJ-Yj-y][0-9]{1,2})|(([A-Za-z][0-9][A-Za-z])|([A-Za-z][A-Ha-hJ-Yj-y][0-9][A-Za-z]?))))\s[0-9][A-Za-z]{2}))$
            locality:
              type: string
              description: Locality
            county:
              type: string
              description: County name
        unencumbered:
          type: boolean
          description: Indicates if the property is unencumbered
        tenure:
          type: string
          pattern: ^(FREEHOLD|LEASEHOLD)$
          description: >
            The tenure of the property Allowed values: [ `FREEHOLD`, `LEASEHOLD`]
        occupancyType:
          type: string
          pattern: ^(OWNER_OCCUPIED|BUY_TO_LET|SECOND_HOME|HOLIDAY_LET)$
          description: >
            Type of occupancy for the property Allowed values: [
            `OWNER_OCCUPIED`, `BUY_TO_LET`, `SECOND_HOME`, `HOLIDAY_LET` ]
        newBuild:
          type: boolean
          description: Indicates if the property is a new build
```