Skip to content
/API Reference

SERV DDP DRSS EAPI (v2)

SERV DDP DRSS API

Facilitates retrieval of Register Seach Statements
Download OpenAPI description
openapi.json
openapi.yaml
Overview
E-mail
legal@servictoria.com.au
Terms of Service
Languages
Servers
Mock server
https://developer.servictoria.io/_mock/portal/rest/ddp-drss-api/openapi
Production environment
https://api.servictoria.io/vicland/ddp
Test environment
https://test.api.servictoria.io/vicland/ddp

getTitleById

Request

Get Register Search Statement (Title) by Title ID

Security
oauthClientCredentials
Path
titleIdstring^([0-9]{1,5})[.][0-9]{1,3}[A,B,C,K,L]{0,1}$required

Unique identifier for land titles consisting of Volume, Folio and Suffix. The Title Id must be in the following format - volume.folio+suffix

Query
registerSearchStatementboolean

Specify if registerSearchStatement (RSS as base64 text) should be included in response.

Default true
registerSearchStatementCertificateboolean

Specify if registerSearchStatementCertificate (RSS as PDF download link) should be included in response.

Default false
Headers
x-source-systemstring

A unique identification string for the source system. This could be a system name or hostname where a system is hosted on multiple hosts.

x-correlation-idstring

A unique transaction id used to correlate api requests end to end.

Example: 123e4567-e89b-12d3-a456-426614174000
Acceptstring

Accept header for content negotiation

Default application/json
account_idstringrequired

Account ID for Reseller's Client

customer_referencestring

Customer reference for auditing/reporting.

Content-Typestring

Content type of the request body

Default application/json
curl -i -X GET \
  'https://developer.servictoria.io/_mock/portal/rest/ddp-drss-api/openapi/titles/{titleId}?registerSearchStatement=true&registerSearchStatementCertificate=false' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'account_id: string' \
  -H 'customer_reference: string' \
  -H 'x-correlation-id: 123e4567-e89b-12d3-a456-426614174000' \
  -H 'x-source-system: string'

Responses

Successful Operation

Bodyapplication/json
titleSearchCertificateobjectrequired

This is the root Digital Register Search Statement (Titles) data type element as exposed to EAPI consumers.

Example: {"titleSearchDetail":{"producedDate":"2021-11-16T11:28:00","copyrightText":"Copyright State of Victoria etc","securityNo":"124230291367D","authenticityToken":"vk69mC7V4Flcv39jhy5vj9yv5"},"titleReferenceDetail":{"titleReference":{"volume":"3049","folio":"244","suffix":"A"},"titleType":"FREEHOLD","ctType":"Electronic","titleStatus":"LIVE"},"landDescription":{"titleDerivationDate":"1976-04-29","landDescriptionText":"Lot 109 on Plan of Subdivision 013485.","landParcels":[{"parcelDescription":"Lot 8 on Registered Plan of Strata Subdivision 011243.","spi":"102 S013485","lotType":"RESTR"}],"parentTitles":[{"titleReference":{"volume":"05210","folio":"928","suffix":"A"}}],"titleDerivationText":"Created by Application No 083788P 03/05/1994","titleDerivation":"AP5610823"},"registeredProprietor":{"expiryDate":"2037-01-01","estateType":"Estate Fee Simple","lifeEstateText":"FOR THE LIFE OF \\nJIM TYLOR of 540 BOURKE ST MELBOURNE","registeredProprietorship":{"effectiveDate":"2021-11-16","registeredProprietorshipText":"This is an identified folio under Section 26E of the Transfer of Land Act 1958 and contains no proprietorship details.\"","proprietorGroups":[{"proprietorDerivationDate":"2011-01-01","tenancyType":"Tenants In Common","proprietorGroupFreeText":"Legal Personal Representative(s) of DESMOND LESLIE DOOLAN deceased","nicoText":"As to the land formerly contained in Volume 09240 Folio 929","mannerOfHoldingForTheShareValue":"Sole Proprietor","shareFraction":{"numerator":1,"denominator":1},"proprietorHoldings":[{"party":{"proprietorNameText":"MARY GIBSON of 1 SMITH STREET DOCKLANDS VIC 3008 Executor(s) of BRUCE ALLAN deceased","personFullName":{"givenNames":[{"givenName":{"value":"EDWINA","order":1}}],"familyName":"GIBSON"},"legalEntityName":"MARY GIBSON","address":"1 JOHNS STREET DOCKLANDS VIC 3008"},"order":1}],"proprietorDerivation":"AJ2464930P","order":1}],"proprietorDerivation":"RP011243","order":1}},"encumbrancesCaveatsAndNotices":{"encumbrances":[{"encumbranceDate":"1999-02-11","encumbrancePriority":1,"encumbranceText":"\"MORTGAGE V852878C 11/02/1999\n NATIONAL AUSTRALIA BANK LTD\"","encumbranceType":"MORTGAGE","encumbranceDocument":"V852878C","affectingEncumbrances":[{"affectingEncumbranceDate":"2001-01-04","affectingEncumbranceType":"Variation of Mortgage","affectingEncumbranceDocument":"V852878C"}],"encumbranceHolders":[{"legalEntityName":"NATIONAL AUSTRALIA BANK LTD","order":1}]}],"notations":[{"notationText":"Any encumbrances created by Section 98 Transfer of Land Act 1958 or Section 24 Subdivision Act 1988 and any other encumbrances shown or entered on the plan set out under DIAGRAM LOCATION below.","notationType":"standard","notationPlan":"LP013485"}]},"diagramLocation":{"diagramReference":"LP013485"},"activityOnTitle":{"numberOfDays":125,"dealings":[{"dealingStatusUpdateDate":"2021-04-21","dealingType":"DISCHARGE OF MORTGAGE","dealingDocument":"AU773220J","dealingStatus":"Registered"}]},"additionalInformation":{"otherTitlesAffectingThisLand":{"titleReference":[{"volume":"05210","folio":"928","suffix":"A"}]},"ownersCorporations":[{"ownersCorporationText":"The land in this folio is affected by OWNERS CORPORATION PLAN NO. SP037224S","ownersCorporationNumber":"1","planNumber":"SP037224S"}],"titleStreetAddress":"2 SMITH STREET COLLINGWOOD 3101","licenceText":"See M1310198N for WATER FRONTAGE LICENCE details","nomination":{"nominationDate":"2016-10-07","nominationText":"AN162198J NOMINATION TO PAPER INST. 07/10/2016 \neCT Nominated to Discharge of Mortgage TO NATIONAL AUSTRALIA BANK LIMITED","nominationDocument":"AN162198J","nominatedTo":"NOMINATION TO PAPER INST.","nominatedToDealing":"DISCHARGE OF MORTGAGE","nominatingParty":"NATIONAL AUSTRALIA BANK LIMITED"},"ectControl":{"effectiveFromDate":"2016-10-07","ectController":"16089P LOCK BULMER & CO"}},"registerSearchStatement":{"data":"Q29weXJpZ2h0IFN0YXRlIG9mIFZpYiBpbWFnZWQgZm9saW8gc2V0IG91dCB1bmRlciBESUFHUkFNIExPQ0FUSU9OIGJlbG93Lg0KDQpESUFHUkFNIExPQ0FUSU9ODQotLS0tLS0tLS0tLS0tLS0tDQpTRUUgTFAyMjE3NzlMIEZPUiBGVVJUSEVSIERFVEFJTFMgQU5EIEJPVU5EQVJJRVMNCg0KQUNUSVZJVFkgSU4gVEhFIExBU1QgMTI1IERBWVMgDQotLS0tLS0tLS0tLS0tLS0tLS0t0KDQpOSUwNCg0KDQoNCkRPQ1VNRU5UIEVORA=="},"registerSearchStatementCertificate":{"link":"https://example.s3.ap-southeast-2.amazonaws.com/example.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJJWE7A6WCRGMKFGQ%2F20180210%2Fap-southeast-2%2Fs3%2Faws4_request&X-Amz-Date=20180210T121323Z&X-Amz-Expires=1800&X-Amz-Signature=12b74b0788aa036bc7c3d03b3f20c61f1f12cc9ad8873e3314233dc479a25351&X-Amz-SignedHeaders=host"}}
titleSearchCertificate.​titleSearchDetailobjectrequired

Contains details relating to context Digital Register Search Statement Search/ Get request.

Example: {"producedDate":"2021-11-16T11:28:00","copyrightText":"Copyright State of Victoria etc","securityNo":"124230291367D","authenticityToken":"vk69mC7V4Flcv39jhy5vj9yv5"}
titleSearchCertificate.​titleSearchDetail.​copyrightTextstringrequired

The copyright text that appears at the top of the Register Search Statement.

Example: "Copyright State of Victoria etc"
titleSearchCertificate.​titleSearchDetail.​securityNostringrequired

Contains the security number that is unique to this Register Search Statement. If a DRSS and RSS were ordered together in the same application, then the DRSS and the RSS will share the same security number.

Example: "124230291367D"
titleSearchCertificate.​titleSearchDetail.​producedDatestringrequired

The date and time that the DRSS was produced by LANDATA. If a DRSS and RSS were requested together in the same application, then the DRSS and the RSS will share the same produced date/time. Whilst the format of the field is YYYY-MM-DD HH:MM:SS, the time is only given to the nearest hour and minute, the seconds will always be 00.`

Example: "2021-11-16T11:28:00"
titleSearchCertificate.​titleSearchDetail.​authenticityTokenstringrequired

The authenticity token is produced only for the Digital Register Search Statement and provides proof that the data relating to a particular RSS request has been sourced from the DRSS. The authenticity token can be decrypted by using the publicly available SERV public key which, if valid, should produce the same security number associated with the original RSS.

Example: "vk69mC7V4Flcv39jhy5vj9yv5"
titleSearchCertificate.​titleReferenceDetailobjectrequired

Digital Register Search Statement reference details.

Example: {"titleReference":{"volume":"3049","folio":"244","suffix":"A"},"titleType":"FREEHOLD","ctType":"Electronic","titleStatus":"LIVE"}
titleSearchCertificate.​titleReferenceDetail.​titleReferenceobject(titleReference)required

The volume, folio and if necessary, the suffix of the title in the Digital Register Search Statement.

titleSearchCertificate.​titleReferenceDetail.​titleReference.​volumestringrequired

Volume of the title in Digital Register Search Statement

titleSearchCertificate.​titleReferenceDetail.​titleReference.​foliostringrequired

Folio of the title in Digital Register Search Statement

titleSearchCertificate.​titleReferenceDetail.​titleReference.​suffixstring

Suffix of the title in Digital Register Search Statement

Enum"A""B""C""K""L"
titleSearchCertificate.​titleReferenceDetail.​titleTypestringrequired

The type of title as indicated on the RSS.

Example: "FREEHOLD"
titleSearchCertificate.​titleReferenceDetail.​ctTypestring

The Certificate of Title type for the title, that is Electronic, Paper, No CofT

Example: "Electronic"
titleSearchCertificate.​titleReferenceDetail.​titleStatusstringrequired

Title status. LIVE or CANCELLED

Example: "LIVE"
titleSearchCertificate.​landDescriptionobject

Land Description

Example: {"titleDerivationDate":"1976-04-29","landDescriptionText":"Lot 109 on Plan of Subdivision 013485.","landParcels":[{"parcelDescription":"Lot 8 on Registered Plan of Strata Subdivision 011243.","spi":"102 S013485","lotType":"RESTR"}],"parentTitles":[{"titleReference":{"volume":"05210","folio":"928","suffix":"A"}}],"titleDerivationText":"Created by Application No 083788P 03/05/1994","titleDerivation":"AP5610823"}
titleSearchCertificate.​registeredProprietorobject

Registered Proprietor Details

Example: {"expiryDate":"2037-01-01","estateType":"Estate Fee Simple","lifeEstateText":"FOR THE LIFE OF \\nJIM TYLOR of 540 BOURKE ST MELBOURNE","registeredProprietorship":{"effectiveDate":"2021-11-16","registeredProprietorshipText":"This is an identified folio under Section 26E of the Transfer of Land Act 1958 and contains no proprietorship details.\"","proprietorGroups":[{"proprietorDerivationDate":"2011-01-01","tenancyType":"Tenants In Common","proprietorGroupFreeText":"Legal Personal Representative(s) of DESMOND LESLIE DOOLAN deceased","nicoText":"As to the land formerly contained in Volume 09240 Folio 929","mannerOfHoldingForTheShareValue":"Sole Proprietor","shareFraction":{"numerator":1,"denominator":1},"proprietorHoldings":[{"party":{"proprietorNameText":"MARY GIBSON of 1 SMITH STREET DOCKLANDS VIC 3008 Executor(s) of BRUCE ALLAN deceased","personFullName":{"givenNames":[{"givenName":{"value":"EDWINA","order":1}}],"familyName":"GIBSON"},"legalEntityName":"MARY GIBSON","address":"1 JOHNS STREET DOCKLANDS VIC 3008"},"order":1}],"proprietorDerivation":"AJ2464930P","order":1}],"proprietorDerivation":"RP011243","order":1}}
titleSearchCertificate.​encumbrancesCaveatsAndNoticesobject

Details on Encumbrances, Caveats and Notices

Example: {"encumbrances":[{"encumbranceDate":"1999-02-11","encumbrancePriority":1,"encumbranceText":"\"MORTGAGE V852878C 11/02/1999\n NATIONAL AUSTRALIA BANK LTD\"","encumbranceType":"MORTGAGE","encumbranceDocument":"V852878C","affectingEncumbrances":[{"affectingEncumbranceDate":"2001-01-04","affectingEncumbranceType":"Variation of Mortgage","affectingEncumbranceDocument":"V852878C"}],"encumbranceHolders":[{"legalEntityName":"NATIONAL AUSTRALIA BANK LTD","order":1}]}],"notations":[{"notationText":"Any encumbrances created by Section 98 Transfer of Land Act 1958 or Section 24 Subdivision Act 1988 and any other encumbrances shown or entered on the plan set out under DIAGRAM LOCATION below.","notationType":"standard","notationPlan":"LP013485"}]}
titleSearchCertificate.​diagramLocationobject

Diagram Location

Example: {"diagramReference":"LP013485"}
titleSearchCertificate.​activityOnTitleobject

Activity On Title

Example: {"numberOfDays":125,"dealings":[{"dealingStatusUpdateDate":"2021-04-21","dealingType":"DISCHARGE OF MORTGAGE","dealingDocument":"AU773220J","dealingStatus":"Registered"}]}
titleSearchCertificate.​additionalInformationobjectrequired

Addition Title Information

Example: {"otherTitlesAffectingThisLand":{"titleReference":[{"volume":"05210","folio":"928","suffix":"A"}]},"ownersCorporations":[{"ownersCorporationText":"The land in this folio is affected by OWNERS CORPORATION PLAN NO. SP037224S","ownersCorporationNumber":"1","planNumber":"SP037224S"}],"titleStreetAddress":"2 SMITH STREET COLLINGWOOD 3101","licenceText":"See M1310198N for WATER FRONTAGE LICENCE details","nomination":{"nominationDate":"2016-10-07","nominationText":"AN162198J NOMINATION TO PAPER INST. 07/10/2016 \neCT Nominated to Discharge of Mortgage TO NATIONAL AUSTRALIA BANK LIMITED","nominationDocument":"AN162198J","nominatedTo":"NOMINATION TO PAPER INST.","nominatedToDealing":"DISCHARGE OF MORTGAGE","nominatingParty":"NATIONAL AUSTRALIA BANK LIMITED"},"ectControl":{"effectiveFromDate":"2016-10-07","ectController":"16089P LOCK BULMER & CO"}}
titleSearchCertificate.​additionalInformation.​otherTitlesAffectingThisLandobject

Other Titles Affecting This Land

Example: {"titleReference":[{"volume":"05210","folio":"928","suffix":"A"}]}
titleSearchCertificate.​additionalInformation.​ownersCorporationsArray of objects

Provides details of the owners corporation as it appears in the Register Search Statement.

Example: [{"ownersCorporationText":"The land in this folio is affected by OWNERS CORPORATION PLAN NO. SP037224S","ownersCorporationNumber":"1","planNumber":"SP037224S"}]
titleSearchCertificate.​additionalInformation.​titleStreetAddressstring

Provides the Street Address of the Title as it appears on the Register Search Statement. Note, not all titles have a definitive title street address.

Example: "2 SMITH STREET COLLINGWOOD 3101"
titleSearchCertificate.​additionalInformation.​licenceTextstring

Text Description of any licenses attached to the title.

Example: "See M1310198N for WATER FRONTAGE LICENCE details"
titleSearchCertificate.​additionalInformation.​nominationobject

Details of a nomination attached to a title.

Example: {"nominationDate":"2016-10-07","nominationText":"AN162198J NOMINATION TO PAPER INST. 07/10/2016 \neCT Nominated to Discharge of Mortgage TO NATIONAL AUSTRALIA BANK LIMITED","nominationDocument":"AN162198J","nominatedTo":"NOMINATION TO PAPER INST.","nominatedToDealing":"DISCHARGE OF MORTGAGE","nominatingParty":"NATIONAL AUSTRALIA BANK LIMITED"}
titleSearchCertificate.​additionalInformation.​ectControlobject

Details regarding Electronic Certificate of Title Controller as displayed on the Register Search Statement.

Example: {"effectiveFromDate":"2016-10-07","ectController":"16089P LOCK BULMER & CO"}
titleSearchCertificate.​registerSearchStatementobject

Register Search Statement as Text (encoded as base64).

Example: {"data":"Q29weXJpZ2h0IFN0YXRlIG9mIFZpYiBpbWFnZWQgZm9saW8gc2V0IG91dCB1bmRlciBESUFHUkFNIExPQ0FUSU9OIGJlbG93Lg0KDQpESUFHUkFNIExPQ0FUSU9ODQotLS0tLS0tLS0tLS0tLS0tDQpTRUUgTFAyMjE3NzlMIEZPUiBGVVJUSEVSIERFVEFJTFMgQU5EIEJPVU5EQVJJRVMNCg0KQUNUSVZJVFkgSU4gVEhFIExBU1QgMTI1IERBWVMgDQotLS0tLS0tLS0tLS0tLS0tLS0t0KDQpOSUwNCg0KDQoNCkRPQ1VNRU5UIEVORA=="}
titleSearchCertificate.​registerSearchStatementCertificateobject

Register Search Statement certificate as PDF file.

Example: {"link":"https://example.s3.ap-southeast-2.amazonaws.com/example.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJJWE7A6WCRGMKFGQ%2F20180210%2Fap-southeast-2%2Fs3%2Faws4_request&X-Amz-Date=20180210T121323Z&X-Amz-Expires=1800&X-Amz-Signature=12b74b0788aa036bc7c3d03b3f20c61f1f12cc9ad8873e3314233dc479a25351&X-Amz-SignedHeaders=host"}
Response
application/json
{
  "titleSearchCertificate": {
    "titleSearchDetail": { … },
    "titleReferenceDetail": { … },
    "landDescription": { … },
    "registeredProprietor": { … },
    "encumbrancesCaveatsAndNotices": { … },
    "diagramLocation": { … },
    "activityOnTitle": { … },
    "additionalInformation": { … },
    "registerSearchStatement": { … },
    "registerSearchStatementCertificate": { … }
  }
}

healthCheck

Request

Health check

Headers
x-correlation-idstring

A unique transaction id used to correlate api requests end to end.

Example: 123e4567-e89b-12d3-a456-426614174000
curl -i -X GET \
  https://developer.servictoria.io/_mock/portal/rest/ddp-drss-api/openapi/health \
  -H 'x-correlation-id: 123e4567-e89b-12d3-a456-426614174000'

Responses

OK

Bodyapplication/json
applicationNamestringrequired

Application Name

applicationVersionstringrequired

Application Version

Example: "1.0.2"
apiNamestringrequired

API Name

Example: "serv-titles-sapi"
environmentstringrequired

Environment

Example: "DEV"
statusstringrequired

Status

Example: "running"
Response
application/json
{
  "applicationName": "string",
  "applicationVersion": "1.0.2",
  "apiName": "serv-titles-sapi",
  "environment": "DEV",
  "status": "running"
}