Skip to main content

Search by Property Description


Overview

Use this service to find out the title number and tenure of a property based on the address supplied.

If you’re a software developer

Use this document to integrate data into your system.


Process flow

Input

Request an official search by sending the following parameters:

  • login details
  • external reference number
  • customer reference
  • address

Validation

Validation diagram (Search by property description) details the validation that the request undergoes.

Search by property description via BG (Business Gateway) flow diagram
Validation diagram Business Rules
Business Rule Decision point BG Code Message ID Message text
BRL-ISBG-001 Is the address valid? N bg.invalid.property.search.criteria MSG-BG-001 Insufficient address details. Please provide flat/house and postcode OR flat, street and town OR house, street and town.
BRL-ISBG-002 Is Postcode valid? N bg.postcode.invalid MSG-BG-004 Please provide valid postcode
BRL-ISBG-003 Were matching properties found? N bg.properties.nopropertyfound MSG-BG-003 No title number has been identified from the data supplied. This does not necessarily mean that a register of a title does not exist but only that insufficient data has matched.
BRL-ISBG-003 Were too many properties returned? Y bg.properties.toomanyproperties MSG-BG-002 The property address you entered has matched with a large number of properties on our database. Please request again with refined address details.

Output

A list of properties and title numbers.


Schemas

A Generic document thumbnail image

RequestSearchByPropertyDescriptionV2_0

XSD
This file may not be suitable for users of assistive technology.

Download

A Generic document thumbnail image

ResponseSearchByPropertyDescriptionV2_0

XSD
This file may not be suitable for users of assistive technology.

Download

A Generic document thumbnail image

Schema explain

PDF, 109KB, 10 pages
This file may not be suitable for users of assistive technology.

Download

Schema explain describes the request schema for the service.

A Generic document thumbnail image

RequestSearchByPropertyDescriptionV2_0Example.xml

XML
This file may not be suitable for users of assistive technology.

Download


Vendor testing

Vendor Test Data (Outstanding requests) documents the data for testing the service.

A Generic document thumbnail image

Vendor Test data

PDF, 207KB, 16 pages
This file may not be suitable for users of assistive technology.

Download