Monitor orders

Monitor the status of your geospatial data orders using the API.


Introduction

After placing the order, a unique order identifier will be displayed in Storage. Your storage allows you to get the status of previously placed orders and monitor the progress of each order. In this guide, you will learn how to monitor the status of individual orders.

Order status

Each order that was placed will be associated with one order status type. A summary is displayed in the table below.

Order statusDescription
PLACEDThe order was placed and it is in progress.
FULFILLEDThe order was successful and the generated assets are ready for download.
FAILED_PERMANENTLYThe order failed. For more information, please contact support.
Learn more

To view more details about the order status types, please read the API reference.

Monitor order status

  1. Get the full information, including the status of all orders:
order_url=https://api.up42.com/workspaces/$workspace_id/orders
curl -L -s -X GET $order_url -H "Authorization: Bearer $PTOKEN" | jq '.'

To find your workspace ID, please follow the instructions from the article Workspaces.

  1. The response body with all the order IDs and corresponding metadata is displayed below:
Loading...
  1. Extract only the order IDs and the status:

curl -L -s -X GET $order_url -H "Authorization: Bearer $PTOKEN" \
| jq '.data.orders[] | .id + " is " + .status'

To proceed, go to Data delivery.