Manage an order

Monitor status of tasking orders and download assets using the API.


You can also view and manage an order using the console.

Monitor tasking orders

After the tasking operation is activated, a unique order identifier will be displayed in Storage. Storage provides a dashboard that allows users to get the status of the previously placed orders and monitor the progress of each order.

The following steps will show you how to monitor the status of individual tasking orders.

  1. Use the previous order ID to track the progress of your placed order:
order_id=182aa8ae-180e-49a7-9af7-8ef497909e4d
curl -L -s -H 'Content-Type: application/json' -H "Authorization: Bearer $PTOKEN" \
https://api.up42.com/workspaces/$workspace_id/orders/$order_id

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

  1. Track the status of this order:
curl -L -s -H 'Content-Type: application/json' -H "Authorization: Bearer \
$PTOKEN" https://api.up42.com/workspaces/$workspace_id/orders/$order_id | jq '.data.status'

Download tasking data

Once images are captured during the tasking operations, your storage will be populated with assets. The following steps will show you how to download the newest assets acquired during the ongoing tasking operation.

  1. To download the newest images captured during the tasking operation, please use the following command:
asset=$(curl -L -s -H 'Content-Type: application/json' \
-H "Authorization: Bearer $PTOKEN" https://api.up42.com/workspaces/$workspace_id/orders/$order_id \
| jq -r '.data.assets[]')

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

  1. Download the asset as a ZIP archive:
asset_data_URL=$(curl -s -L GET https://api.up42.com/workspaces/$workspace_id/assets/$asset/downloadUrl \
-H "Authorization: Bearer $PTOKEN" | jq -j '.data.url')
curl -s -L $asset_data_URL -H "Authorization: Bearer $PTOKEN" -o my_tasking_order.zip

By following these steps, you will be able to view the list of available collections and data products, perform a search for your set of requirements (preferred area of interest, search interval and quality criteria), get an estimate from the support team, activate the tasking operation and download tasking data.