Manage an order

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


You can also view and manage tasking orders 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