# Orders

## Create from Template

 - [POST /v1/order](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-createorderfromtemplate.md): Create an order using a specified template Id.

## Retrieve

 - [GET /v1/order](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-getorders.md): Retrieve all orders created by OpenAPI calls. This endpoint does not return orders created on-platform.

## Delete

 - [DELETE /v1/order/{id}](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-deleteorder.md): Deletes an order that is in draft or edits needs status.

## Proof

 - [GET /v1/order/{id}/proof/{recipient?}](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-getorderproof.md): Retrieve the auto-generated proof for a specified order in PDF format. The proof contains front, page and envelope (if applicable) pages.

## Analytics

 - [GET /v1/order/{id}/analytics](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-statistics.md): Retrieve order analytics such as delivery, number of recipients and order status from a given order id.

## Transactions

 - [GET /v1/order/{id}/transaction](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-transactions.md): Retrieve transaction data from order id.

## Checkout Summary

 - [GET /v1/order/{id}/checkout](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-calculateordercheckout.md): Calculate and retrieves the line item cost, production and estimated delivery details for a specific order for review prior to executing the checkout.
This is not required to be called before executing a checkout.

## Checkout

 - [POST /v1/order/{id}/checkout](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-postordercheckout.md): Executes the checkout process for a specified order using its unique Order Id. Upon success, credits or payment methods will be charged for the order. To review the cost prior to execution, call Checkout Review.

## Retrieve Recipients

 - [GET /v1/order/{id}/recipients](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-getrecipientsfromorder.md): Retrieve a list of recipients associated to a specific order.

## Delete Recipients

 - [DELETE /v1/order/{id}/recipients](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-deleterecipientsfromorder.md): Delete recipients associated with a specific order in draft or edits needed status.

## Add Recipients

 - [PUT /v1/order/{id}/recipients:append](https://docs.lettrlabs.com/lettrlabs_api_reference/orders/v1-external-orders-appendrecipientstoorder.md): Add recipients to a specified order in draft or edits needed status.
Recipients will run through address validation, and the response will return how many are valid.
Any recipients that have incomplete addresses will not be added to the order. Define mail-merge, image-merge, return address override, and other metadata at the recipient level.