Ordering Course

This document provides an overview of the GBDX ordering process.

Last Updated: June 25, 2019


DigitalGlobe 1B products can be ordered and delivered to The GBDX Platform on an as-needed basis. Ordering a 1B product means sending a request to the DigitalGlobe Factory to deliver the product to The GBDX Platform.

The GBDX ordering process is as follows:

  1. An order is placed for a DigitalGlobe 1B product.
  2. The DigitalGlobe Factory delivers the product to the GBDX S3 receiving bucket. This can take several hours.
  3. The status of the product in the GBDX catalog is updated to "delivered" and the s3 location is appended to the product record.
  4. The product is now available for use.

Datasets that Require Ordering

The GBDX Catalog includes datasets from DigitalGlobe and third-party datasets. Only DigitalGlobe products need to be ordered. Third-party open source data is available for use without ordering.

Products from the following datasets need to be ordered:


Note: WORLDVIEW-4 content is only available through Raster Data Access (RDA). Ordering WORLDVIEW-4 data to the GBDX catalog is not supported.

Third party or open source datasets that do not need to be ordered include:

Data Retention

DigitalGlobe 1B products are deleted from the GBDX Platform after 30 days of no access. "Access" means the product has been ordered or used as an input to a Workflow. If you need access to an image that has been deleted, you can order it again.

We recommend adding the Auto_Ordering task to the Workflow definition. See Auto Ordering Task Tutorial.

Ordering Limits

Orders are limited to 100 catalog IDs per order request.

How to Order DigitalGlobe 1B Products

There are three ways to place an order:

  • Add the Auto_Ordering task to a Workflow
  • Make a request to the Ordering API
  • Make a request to the Ordering with Callbacks API

You can also make API requests to check the status of an order and to get the S3 location for a product.

Auto Ordering Task

Include the Auto_Ordering task in your workflow definition. This task takes a Catalog ID as input. This is the simplest method for ordering imagery products to use in a Workflow. It also ensures that an image that has been purged from the GBDX receiving bucket will be ordered again when you need it.

To learn how to add the Auto_Ordering task to a workflow, see Auto Ordering Task Tutorial

Ordering API

When make a POST request to the GBDX Ordering API, you'll include the list of catalog IDs to be ordered. The list can include up to 100 catalog IDs.

To learn how to make a request to the Ordering API, see Place an Order

Ordering with Callbacks API

You can place an order and get callback notifications by making a request to the Ordering Callbacks (/ordercb) API endpoint.

To learn how to make an ordering with callbacks request, see Place an Order with Callbacks.

Check the Status of an Order

When you place an order using the Ordering API, the response will include an Order ID. You can check the status of the order by making an API request with the Order ID.

To learn how to check the status of an order, see Check the status of an order

Get the S3 location for a Product

You can make a request to the Ordering API to get the S3 location of a product. This request does not return the details of an order.

To learn how to get the S3 location for a product, see Get the S3 Location for a Product Tutorial

What’s Next

Learn how to add the Auto Ordering task to a Workflow