# GET proprietors

Get information about the matched proprietors and the associated titles.

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

## Query parameters:

  - `lastName` (string)
    Last name of the proprietor. Either last name or company name must be populated. This will search for individual with the provided input.
The search is case insensitive.
If a given name is not provided, the results will include proprietors with the matching last name, but any given name.
    Example: "Smith, Van Doorn, Ewing-Pistos, O'Reily"

  - `givenName` (string)
    Given name(s) of the proprietor. Can be used in conjunction with a last name.
Not applicable for companies.
    Example: "Mary-Anne"

  - `companyName` (string)
    Company name. Either company name or last name must be populated. This will search for companies with the provided input.
    Example: "SERV"

  - `pageNumber` (integer)
    Page number starting at 1. Each page contains up to 200 results.

## Header parameters:

  - `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):

  - `proprietorSummaries` (array, required)

  - `proprietorSummaries.lastName` (string)
    Proprietor's last name.
    Example: "Armstrong"

  - `proprietorSummaries.givenName` (string)
    Proprietor's given name.
    Example: "Nathan"

  - `proprietorSummaries.companyName` (string)
    Company name.

  - `proprietorSummaries.titleDetails` (object, required)

  - `proprietorSummaries.titleDetails.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=="

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

  - `proprietorSummaries.titleDetails.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"

  - `proprietorSummaries.titleDetails.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"

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

  - `proprietorSummaries.titleDetails.municipality` (string)
    The municipality of the title.
    Example: "GREATER BENDIGO"

  - `pagination` (object, required)

  - `pagination.pageSize` (integer, required)
    Total number of records per page.

  - `pagination.nextPage` (integer)
    Number for the next page.
    Example: 2

## 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 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.