WorldView 2D Tasking
Overview
The 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 tasking, a tutorial and examples, and API reference.
Tasking API Version 2
Tasking was upgraded to a new system on December 9, 2025. Tasking requests must be placed through V2 endpoints which are found under the tasking/v2 base path.
User guides and examples
| Page | Topic |
|---|---|
| Intro to Tasking | An overview of Tasking through the Tasking API. If you're new to Tasking, read this first. |
| Product Default Recipes | The default settings for the delivered imagery products. |
| Example: Request for FlexView 30 CM Color | A FlexView tasking request example for 30 cm color, View-Ready Ortho (OR2A) imagery. |
| Example: Request for FastView 50 CM Color | A FastView tasking request example for 50 cm System-Ready (1B) imagery. |
| Validation and Errors | Describes the validation checks and statuses in the Tasking workflow. |
API reference
| Page | Topic |
|---|---|
| Tasking Request Limits | The limitations on the number of tasking requests that can be placed in an hour. |
| Tasking End Use Codes | Allowed values for the required "end use code" tasking parameter. |
| Tasking Status and Errors | Status definitions and common error messages for failed statuses. |
POST Quote a Tasking Request | Get a usage estimate quote for a tasking request before submitting. |
POST Submit FastView Tasking | Submit a FlexView tasking request. |
POST Submit FlexView Tasking | Submit a FlexView tasking request. |
PATCH Patch FlexView Tasking | Patch a FlexView tasking request to extend its end date. |
GET Get the Status of a Tasking Request | Get 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 Requests | Lists all tasking requests for the account. |
POST Cancel a Tasking Request | Cancel a tasking request before it's fulfilled. Requires the tasking ID. |
V1 API legacy endpoints
The following endpoints are available for existing tasking users to maintain any pending tasking requests placed in the V1 API.
| Page | Topic |
|---|---|
GET Get the Status of a V1 Tasking Request | Get the latest status and details for a tasking request. Requires the V1 ID which was provided in the response when the tasking request was submitted. |
GET List all V1 Tasking Requests | Lists all tasking requests for the account. |
POST Cancel a Tasking Request | Cancel a tasking request before it's fulfilled. Requires the V1 tasking ID. |
Existing tasking requests placed in V1 are safe "on the deck" and will complete. You can use the V1 GET Tasking endpoint to check their status. If you wish to manually migrate outstanding tasking requests to the V2 tasking system you can reproduce them in V2 and then cancel the V1 request.
V1 and V2 APIs are exclusive and cannot retrieve each other's requests. A V1 tasking ID can only be retrieved from the V1 endpoint. Attempting to retrieve a tasking ID that does not exist will return a 404 Not Found error. V2 tasking IDs have the suffix "-TASK" appended to the numerical ID and can be used to determine which API the tasking request was created in.