# Orders API

List available products, place orders, view order history, and retrieve ordered products.

Version: 1.11.1

## Servers

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

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

## Security

### oauthClientCredentials

OAuth 2.0 Client Credentials authentication.

Token URLs by environment:
- **Production**: https://auth.servictoria.com.au/oauth/token
- **UAT/Test**: https://stg.auth.servictoria.com.au/oauth/token


Type: oauth2

## Download OpenAPI description

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

## Product Listing

### GET products

 - [GET /orders/v1/products](https://developer.servictoria.io/portal/rest/ddp-orders-api/openapi/product-listing/getproducts.md): Get the list of certificate products available for order on a specified title, by providing a volume & folio number or encrypted title ID created by discovery APIs.
The response will include important details about each product like the pricing, description, pre-requisites, responsible authority, turnaround time and more.

## Extra Data

### GET owners corporation managers

 - [GET /orders/v1/extra-data/owners-corporation-managers](https://developer.servictoria.io/portal/rest/ddp-orders-api/openapi/extra-data/getownerscorporationmanagers.md): List extra data owners corporation (OC)) managers.
This is a reference dataset for the list of all OC managers in Victoria, to be used when required to choose one as customer provided extra data in product orders. This list is maintained by SERV, new owners corporation managers are added regularly.

### GET municipalities

 - [GET /orders/v1/extra-data/municipalities](https://developer.servictoria.io/portal/rest/ddp-orders-api/openapi/extra-data/getmunicipalities.md): List extra data municipalities.
This is a reference dataset for the list of all OC managers in Victoria, to be used when required to choose one as customer provided extra data in product orders.

## Orders

### POST orders

 - [POST /orders/v1](https://developer.servictoria.io/portal/rest/ddp-orders-api/openapi/orders/postorder.md): Submit an order for Landata information products when ready for confirming the purchase.
Provide the list of products intended for purchase, along with customer account details, pre-requisites or extra data required and a title identifier.

### GET orders

 - [GET /orders/v1](https://developer.servictoria.io/portal/rest/ddp-orders-api/openapi/orders/getorders.md): Get a paginated list of past orders. This will provide a history of orders made by a specified customer along with full captured details of each order and the summary of included items.

### GET order

 - [GET /orders/v1/{orderId}](https://developer.servictoria.io/portal/rest/ddp-orders-api/openapi/orders/getorder.md): Get details of an order.
This will provide details of a specified order using the order ID along with full captured details of each order and the summary of included items.

### GET order item

 - [GET /orders/v1/{orderId}/item/{orderItemNumber}](https://developer.servictoria.io/portal/rest/ddp-orders-api/openapi/orders/getorderitem.md): Get details of an ordered item. Item refers to a product purchased as part of an order.
Provide the order number along with Order item number to recieve its details including the information product itself in the available format/s.

### POST decrypt titles

 - [POST /orders/v1/titles/decrypt](https://developer.servictoria.io/portal/rest/ddp-orders-api/openapi/orders/decrypttitleid.md): API which accepts a list of encrypted titleIds and returns a list of decrypted titleIds (aka Volume/Folios).