Notifications

While you can poll the Orders API for an order periodically to determine its state and whether it is ready for download, the Orders API also supports email and webhook notification options, making it easier for you to follow order progress.

Email Notifications

To enable email notifications for an order, you can specify "email": true as a notification option in your order request. By default, this value will be set to false. When enabled, an email will be delivered to the email address of the user who created the order when the order reaches a success, partial, or failed state.

Example Request

POST https://api.planet.com/compute/ops/orders/v2
{  
   "name":"basic order with email notification",
   "products":[  
      {  
         "item_ids":[  
            "20151225_233020_0c74"
         ],
         "item_type":"PSScene4Band",
         "product_bundle":"analytic"
      }
   ],
   "notifications":{  
      "email": true
   }
}

Webhook Notifications

To enable webhook notifications for an order, you can specify webhook URL for notification when your order is ready. If a cloud storage delivery option is not specified in the order, the webhook will contain the URLs to the downloadable files.

By default, the provided webhook will be called for each delivered item. You can request a single webhook call per order by including the "per_order": true parameter.

Example Request

POST https://api.planet.com/compute/ops/orders/v2
{  
   "name":"basic order with per order webhook notification",
   "products":[  
      {  
         "item_ids":[  
            "20151225_233020_0c74"
         ],
         "item_type":"PSScene4Band",
         "product_bundle":"analytic"
      }
   ],
   "notifications":{  
      "webhook":{  
         "per_order": true,
         "url":"{URL}"
      }
   }
}