Skip to main content

Tasking

Overview

The MGP Tasking API lets you request a new imagery collection over your Area of Interest (AOI) within a specified time frame. You may include additional parameters such as image resolution and off-nadir angle. Within the Tasking documentation you'll find an introduction to MGP tasking, a tutorial and examples, and API reference.

User guides and examples

PageTopic
Intro to TaskingAn overview of MGP Tasking through the Tasking API. If you're new to MGP Tasking, read this first.
Tutorial: How to Place a Tasking RequestA step-by-step tutorial for creating a tasking request body.
Core Imagery Default RecipesThe default settings for each of the core imagery products.
Example: Request for 30 CM ColorA tasking request example for 30 cm color, view-ready ortho (OR2A) imagery.
Example: Request for 50 CM ColorA tasking request example for 50 cm system-ready (1B) imagery.
Validation and ErrorsDescribes the validation checks and statuses in the Tasking workflow.

API reference

PageTopic
Tasking Request LimitsThe limitations on the number of tasking requests that can be placed in an hour.
Tasking ParametersA table that describes the required and optional parameters of a tasking request.
Tasking End Use CodesAllowed values for the required "end use code" tasking parameter.
Tasking Status and ErrorsStatus definitions and common error messages for failed statuses.
POST Quote a Tasking RequestGet a usage estimate quote for a tasking request before submitting.
POST Submit a Tasking RequestSubmit a tasking request, or add validation_only=true to the URL path to validate the request before submitting.
GET Get the Status of a Tasking RequestGet the latest status and details for a tasking request. Requires the order ID which was provided in the response when the tasking request was submitted.
GET List all Tasking RequestsLists all tasking requests for the account.
POST Cancel a Tasking RequestCancel a tasking request before it's fulfilled. Requires the tasking order ID.