# API Access

### DRSS API

This API provides a Synchronous method of retrieving the **Digital Register Search Statement (DRSS)**, together with a text version of the Register Search Statement (RSS).

#### Request

###### Location

< baseURL > /vicland/ddp/drss/v2/titles/<titleId>

###### Headers

| Key | Value |
|  --- | --- |
| content-type | application/json |
| account_id | An Account Identifier that you wish to attach to the request for your reference (**Mandatory**) |
| customer_reference | A text field containing a customer reference of the request for your records (**Optional**) |


###### Authorisation

| Key | Value |
|  --- | --- |
| Bearer Token | < token > |


###### GET Variable

| Key | Value |
|  --- | --- |
| titleId | The Volume/Folio of the Title.   **Note:** Replace the forward slash (/) with a Period (.) For example: 10000/100 -> 10000.100 |


###### Sample Request


```
curl --location '<baseURL to be Provided>/vicland/ddp/drss/v2/titles/<titleId>' \ 
--header 'content-type: application/json' \ 
--header 'account_id: <account ID>' \ 
--header 'customer_reference: <Customer reference>' \ 
--header 'Authorization: Bearer <token>'
```

#### Response

The response from the request will be the Digital Register Search Statement in JSON as defined in the **DRSS Data Definition**

A sample response that includes all possible fields is given below:


```
{ 
   "titleSearchCertificate": { 
         "titleSearchDetail": { 
               "copyrightText": "", 
               "securityNo": "", 
               "producedDate": "", 
               "authenticityToken": "" 
         }, 
         "titleReferenceDetail": { 
              "titleReference": { 
                  "volume": "", 
                  "folio": "", 
                  "suffix": "" 
            }, 
           "titleType": "", 
           "ctType": "", 
           "titleStatus": "" 
         }, 
         "landDescription": { 
              "landDescriptionText": "", 
              "landParcels": [{ 
                  "parcelDescription": "", 
                  "spi": "", 
                  “lotType”: ""  
            }], 
              "parentTitles": [{ 
                  "titleReference": { 
                        "volume": "", 
                        "folio": "", 
                        "suffix": "" 
                   } 
            }], 
              "titleDerivationText": "", 
              "titleDerivation": "", 
              "titleDerivationDate": "" 
         }, 
         "registeredProprietor": { 
              "estateType": "", 
              "expiryDate": "", 
              "lifeEstateText": "", 
              "registeredProprietorship": { 
                   "registeredProprietorshipText": "", 
                   "proprietorGroups": [{ 
                         "tenancyType": "", 
                         "proprietorGroupFreeText": "", 
                         "nicoText": "", 
                         "mannerOfHoldingForTheShareValue": "", 
                         "shareFraction": { 
                            "numerator": , 
                            "denominator":  
                         }, 
                         "proprietorHoldings": [{ 
                            "party": { 
                               "proprietorNameText": "", 
                                  "personFullName": { 
                                     "givenNames": [ 
                                     { 
                                       "givenName": { 
                                       "value": "", 
                                       "order": 1 
                                       } 
                                  } 
                                  ], 
                                  "familyName": "" 
                               }, 
                            "legalEntityName": "", 
                            "address": "" 
                         }, 
                         "order":  
                   }], 
                   "proprietorDerivation": "", 
                   "proprietorDerivationDate": "", 
                   "order":  
                 }] 
            } 
      }, 
      "encumbrancesCaveatsAndNotices": { 
            "encumbrances": [{ 
                   “encumbrancePriority”: 
                   "encumbranceText": "", 
                   "encumbranceType": "", 
                   "encumbranceDocument": "", 
                   "encumbranceDate": "", 
                   "affectingEncumbrances": [{ 
                         "affectingEncumbranceType": "", 
                         "affectingEncumbranceDocument": "", 
                         "affectingEncumbranceDate": "" 
                   }], 
                   "encumbranceHolders": [{ 
                         "legalEntityName": "", 
                         "order":  
                   }] 
            }], 
            "notations": [{ 
                   "notationText": "", 
                   "notationType": "", 
                   "notationPlan": "" 
            }] 
      }, 
      "diagramLocation": { 
            "diagramReference": "" 
      }, 
      "activityOnTitle": { 
            "numberOfDays": , 
            "dealings": [{ 
                   "dealingType": "", 
                   "dealingDocument": "", 
                   "dealingStatus": "", 
                   "dealingStatusUpdateDate": "" 
            }] 
      }, 
      "additionalInformation": { 
            "otherTitlesAffectingThisLand": { 
                   "titleReference": [{ 
                         "volume": "", 
                         "folio": "", 
                         "suffix": "" 
                   }] 
            }, 
            "ownersCorporations": [{ 
                   "ownersCorporationText": "", 
                   "ownersCorporationNumber": "", 
                   "planNumber": "" 
            }], 
            "titleStreetAddress": "", 
            "licenceText": "", 
            "nomination": { 
                   "nominationText": "", 
                   "nominationDocument": "", 
                   "nominatedTo": "", 
                   "nominatedToDealing": "", 
                   "nominatingParty": "", 
                   "nominationDate": "" 
            }, 
            "ectControl": { 
                   "ectController": "", 
                   "effectiveFromDate": "" 
            } 
      }, 
      "registerSearchStatement": { 
            "data": "" 
      } 
   } 
}
```