# GET titles

Get information about the matched titles including the associated properties and parcels.
You can provide a Volume and Folio number or the encrypted title identifier provided from other discovery APIs.
This supports confirmation of the right title and/or property.

Endpoint: GET /discovery/v1/titles
Version: 1.9.0
Security: oauthClientCredentials

## Query parameters:

  - `titleId` (string, required)
    Title identifier, this can be either a volume/folio (eg: '10940/843') or an encrypted titleId as
returned by operations on this API (eg: 'qp0gjuieZ5VzbNKtT/eZvqPryobRkEYxMA==' - this example is valid
for the TEST environment only). The encrypted titleId's value is not guaranteed to remain stable over time.
Customers should avoid relying on its persistence or consistency across API calls or over extended periods.
    Example: "10940/843"

  - `premium` (boolean)
    For customers who have premium access, specifies whether to include premium-only results in the discovery responses.
If set to true, premium information (unencrypted title IDs) will be included in the response.
Note that enabling this option may incur discovery charges. Customer will not be charged if the titleId is a volume/folio, rather than an encrypted titleId.
    Example: true

## Header parameters:

  - `customer-id` (string)
    Identifier of the customer this request is on behalf of. For premium discovery requests only.
    Example: "12345"

  - `customer-reference` (string)
    Optional description to identify a transaction, used for billing purposes. Note that we'll be providing a separate order ID once the order has been submitted. For premium discovery requests only.
    Example: "customer-reference-001"

  - `idempotency-key` (string)
    Unique UUID used to prevent duplicate premium discovery orders. For premium discovery only.
This allows requests to be retried after a network failure without accidentally submitting two premium discovery orders.
If you receive a network error or timeout, you should resend the request with the same idempotency-key.
If the server is still processing the original POST, you will receive 429 Too Many Requests.
Idempotency keys expire after 24 hours.
    Example: "cc4d91e3-17af-4d11-b333-eb449e62ff07"

  - `x-correlation-id` (string)
    Optional unique UUID which can assist with tracing / debugging requests.
    Example: "824993ab-7366-4faa-963d-c456dec227a5"

## Response 200 fields (application/json):

  - `titleSummaries` (array, required)

  - `titleSummaries.titleId` (string, required)
    An encrypted title identifier. Access to Vol/Fol is available only for premium discovery due to associated charges.
This value is not guaranteed to remain stable over time. Customers should avoid relying on its persistence or consistency across API calls or over extended periods.
    Example: "qp0gjuieZ5VzbNKtT/eZvqPryobRkEYxMA=="

  - `titleSummaries.volumeFolio` (string)
    For premium discovery responses, this field contains the Volume/Folio (Vol/Fol) of a title.
    Example: "10940/843"

  - `titleSummaries.titleStatus` (string, required)
    The status of the title informs whether it is currently active, has become cancelled or partially cancelled.
    Enum: "ACTIVE", "CANCELLED", "PARTIALLY_CANCELLED"

  - `titleSummaries.titleType` (string, required)
    Describes the ownership type of the title, the main two being Freehold for property owned by individuals and companies, and Crown land which is administered by public authorities.
    Enum: "ALPINE_LEASE", "CITY_LINK_LEASE", "CROWN_GRANT", "CROWN_LAND", "CROWN_LEASE", "FREEHOLD", "IDENTIFIED", "MINERAL_EXCLUDES", "MINERAL_INCLUDES", "TREASURERS_RECEIPT"

  - `titleSummaries.titleReference` (object)
    The identifier of a title made up of a volume number and a folio number separated by a slash. It is the numbering system used for titles, Crown Grants, Crown Leases and Mineral Leases. If volume folio was provided in the search, then, this field will return volume folio

  - `titleSummaries.titleReference.volume` (integer)
    The volume number containing the title. This originates from physical books named volumes, containing sections known as folios.

  - `titleSummaries.titleReference.folio` (integer)
    This can represent plan number, dealing number, document number etc.

  - `titleSummaries.titleReference.suffix` (string)
    Unique id to identify authority who owns the product

  - `titleSummaries.copyOfTitleType` (string, required)
    The certificate of title may either be stored only electronically in the the Victorian Online Titles System (VOTS) or a duplicate may exist in physical paper format.
    Enum: "ELECTRONIC", "PAPER"

  - `titleSummaries.titleStreetAddress` (string)
    Address recorded against the title
    Example: "UNIT 328 LEVEL 3 800 SWANSTON STREET CARLTON VIC 3053"

  - `titleSummaries.landDescriptionText` (string)
    The parcel(s) associated with the title are described in the Land Description.
    Example: "Lot 3A2 on Plan of Subdivision 515587S."

  - `titleSummaries.landParcels` (array)

  - `titleSummaries.landParcels.spi` (string, required)
    A Standard Parcel Identifier (SPI) uniquely identifies a parcel. An SPI typically consists of either a Lot on Plan or a Crown Allotment.
A Lot on Plan defines the allocated lot number on a particular plan. For example '101\PS328573' is lot 101 on the plan of subdivision 328573.
There are instances of an SPI not containing a lot, eg: 'TP109554'.
A Crown Allotment parcel is defined by up to five different factors including Allotment, Block, Portion, Section and SubDivision.
For example '12~10A\PP5762' is Allotment 12 in Section 10a on the Parish Plan 5762.
    Example: "3A2\\PS515587"

  - `titleSummaries.landParcels.parcelType` (string)
    The parcel types determine what can be done with the parcel. The type can be a lot (a normal parcel of land), a unit (belonging to an apartment development), Common property (jointly owned land as defined by something such as a body corporate), roads or reserves.
    Enum: "COMMON_PROPERTY", "LOT", "RESERVE", "ROAD", "UNIT"

  - `titleSummaries.landParcels.lotType` (string)
    The lot type gives an indication of the use of the parcel or describes any lot limitations. Generally when the parcel has a parcel type of ‘lot’ or ‘unit’. They can be restricted (meaning it must be sold with another parcel), unrestricted (it does not need to be sold along with another parcel), an accessory unit like a storage area in an apartment complex or a carpark.
    Enum: "ACCESSORY_UNIT", "CARPARK", "RESTRICTED", "UNRESTRICTED"

  - `titleSummaries.landParcels.parcelStatus` (string)
    The status of a parcel identifies whether it is active or proposed.
This is where a parcel sub-division has not yet been fully completed but has gone through a significant way through the approval stage and so recognised as proposed.
    Enum: "ACTIVE", "PROPOSED"

  - `titleSummaries.landParcels.lot` (string)
    Example: "3A2"

  - `titleSummaries.landParcels.planNumber` (string)
    Example: "PS515587S"

  - `titleSummaries.landParcels.parish` (string)
    Parish name.
    Example: "YEO"

  - `titleSummaries.landParcels.township` (string)
    Township name.
    Example: "BARWON DOWNS TP"

  - `titleSummaries.landParcels.allotment` (string)
    Crown Allotment.
Crown Allotment descriptor.
    Example: "15D"

  - `titleSummaries.landParcels.block` (string)
    Crown Block.
A part of the parcel descriptor. It is utilized in combination with either Lot and Plan number or Allotment and Parish code.
    Example: "1"

  - `titleSummaries.landParcels.section` (string)
    Section.
A part of the parcel descriptor. It is utilized in combination with either Lot and Plan number or Allotment and Parish code.
    Example: "A"

  - `titleSummaries.landParcels.portion` (string)
    Crown Portion.
Crown Portion descriptor.
    Example: "105"

  - `titleSummaries.landParcels.subdivision` (string)
    Crown Subdivision.
Crown Subdivision descriptor.
    Example: "16"

  - `titleSummaries.properties` (array)

  - `titleSummaries.properties.propertyPfi` (string, required)
    Property persistent feature identifier (PFI) which uniquely identifies a property.
    Example: "208045633"

  - `titleSummaries.properties.isMultiAssess` (boolean, required)
    Example: true

  - `titleSummaries.properties.propertyStatus` (string, required)
    Status of the property.
    Enum: "ACTIVE", "PROPOSED"

  - `orderSummary` (object)

  - `orderSummary.orderId` (string, required)
    Unique number to identify an order.
    Example: "10219435"

  - `orderSummary.totalPrice` (integer, required)
    The total price (in cents) for this order (including gst).
    Example: 891

  - `orderSummary.totalGst` (integer, required)
    The total GST amount (in cents) for this order.
    Example: 89

## Response 400 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 401 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 403 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 404 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 429 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.

## Response 500 fields (application/json):

  - `errorType` (string)
    Stable error code that can be used to decide how to hand an error.
    Example: "UNAUTHORIZED"

  - `errorMessage` (string)
    Invalid Authorization token.