# Order history

Managing order history.

## List of all remarks

 - [GET /api/orders/history/snapshot](https://api.docs.shoptet.com/shoptet-api/openapi/order-history/getlistofallremarks.md): Using this endpoint, you can get list of all remarks with detailed info of each remark asynchronously.

See how Asynchronous requests work on our developer's portal.

Response will be in jsonlines format with each remark taking one line of output file.

One remark in response has the same format as an item in List of remarks for order and is extended with  field, which identifies the relation to the order.

Use  request parameter to get the list of specific orders remarks. Order codes are separated by a comma. Please note that this parameter .

Result file is compressed using GZIP.

## List of remarks for the order

 - [GET /api/orders/{code}/history](https://api.docs.shoptet.com/shoptet-api/openapi/order-history/getlistofremarksfororder.md): The endpoint shows the order history which is displayed in Shoptet
administration in the

“History” tab, in the order detail. Thus they are the most important
system actions that have affected the order (they cannot be

changed by the user) and then the notes added by the e-shop, primarily
intended as messages between several employees,

which may be needed to coordinate the order processing (these can be
entered and deleted by the user).

## Insertion of remark to order

 - [POST /api/orders/{code}/history](https://api.docs.shoptet.com/shoptet-api/openapi/order-history/createorderremark.md): This endpoint may be used to add the user remark into the order history.

For example the payment gateway may give the payment identification at
its side, or

add the remarks during the process of payment or order processing. The
remarks

are displayed in administration, in the “History” tab, in the order
detail,

together with main system changes of the order.

## Delete order history item

 - [DELETE /api/orders/{code}/history/{id}](https://api.docs.shoptet.com/shoptet-api/openapi/order-history/deleteorderhistoryitem.md): Delete order history item by primary key.