# API Access

### Title Alert API

This API provides a Synchronous method of retrieving **Subscribing** the VolumneFolio and receiving **Title Alert Responses**.

#### Request

###### Location

< baseURL > /vicland/alert/v1/titles/subscriptions

###### Headers

| Key | Value |
|  --- | --- |
| content-type | application/json |


###### Authorisation

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


###### Sample Subscription Request Payload


```
{
    "volumeFolio": "9500/906",
    "customerRef": "CBA",
    "startDateTime": "2024-02-01T00:00:00",
    "endDateTime": "2024-03-11T00:00:00"
}
```

#### Sample Title Alert Webhook Request Payload

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


```
{
  "eventId": "01014c20-0061-4490-8cde-7e07da318aba",
  "eventType": "title_alert_notification",
  "eventDate": "2024-11-22T01:25:07.516525+00:00",
  "data": {
    "notificationId": "01014c20-0061-4490-8cde-7e07da318aba",
    "subscriptionId": "c9456b07-a825-4fb4-b4af-20567d56a71d",
    "volumeFolio": "10793/317",
    "customerRef": "",
    "activityType": "PRELODGE",
    "activityTime": "2024-11-15T03:22:05Z"
  }
}
```