# Discovery API

Version: 1.10.0

## Servers

Production environment
```
https://api.servictoria.io/ddp
```

Test environment
```
https://test.api.servictoria.io/ddp
```

## Security

### oauthClientCredentials

Type: oauth2

## Download OpenAPI description

[Discovery API](https://developer.servictoria.io/_bundle/portal/rest/ddp-discovery-api/@latest/ddp-discovery-api.yaml)

## Other

### GET properties

 - [GET /discovery/v1/properties](https://developer.servictoria.io/portal/rest/ddp-discovery-api/ddp-discovery-api/other/getproperties.md): Get information about the matched properties including the associated titles and parcels.
You may provide only one of the three identifiers - an address, Council Property Number (CPN) in combination with Municipality or Property Persistent Feature Identifier (PFI).
This helps to confirm the right title and/or property before then making an order for available certificates.

### GET titles

 - [GET /discovery/v1/titles](https://developer.servictoria.io/portal/rest/ddp-discovery-api/ddp-discovery-api/other/gettitles.md): 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.

### GET parcels

 - [GET /discovery/v1/parcels](https://developer.servictoria.io/portal/rest/ddp-discovery-api/ddp-discovery-api/other/getparcels.md): Get information about the matched parcels including associated titles and properties. Provide a Standard Parcel Identifier (SPI).

### Retrieve Crown allotment parcels including parcel SPI

 - [GET /discovery/v1/parcels/crown-allotments](https://developer.servictoria.io/portal/rest/ddp-discovery-api/ddp-discovery-api/other/getparcelcrownallotmentsearch.md): Retrieve a list of Crown allotment parcels that match the Crown allotment search criteria.
The response includes each parcel's SPI, which can be used to obtain detailed parcel information.

### GET proprietors

 - [GET /discovery/v1/proprietors](https://developer.servictoria.io/portal/rest/ddp-discovery-api/ddp-discovery-api/other/getproprietors.md): Get information about the matched proprietors and the associated titles.

### GET individual proprietor names

 - [GET /discovery/v1/proprietor-names/individual](https://developer.servictoria.io/portal/rest/ddp-discovery-api/ddp-discovery-api/other/getproprietornamesindividual.md): Get information about the matched individual proprietor names.
At least one of lastName or givenName must be provided.

### GET company proprietor names

 - [GET /discovery/v1/proprietor-names/company](https://developer.servictoria.io/portal/rest/ddp-discovery-api/ddp-discovery-api/other/getproprietornamescompany.md): Get information about the matched company proprietor names.

### GET parishes

 - [GET /discovery/v1/parishes](https://developer.servictoria.io/portal/rest/ddp-discovery-api/ddp-discovery-api/other/getparishes.md): Get information about all the available parishes.

### GET townships

 - [GET /discovery/v1/townships](https://developer.servictoria.io/portal/rest/ddp-discovery-api/ddp-discovery-api/other/gettownships.md): Get information about all the available townships.