# WorldView Tasking

## Overview[​](#overview "Direct link to Overview")

The Tasking API lets you request data collection over your Area of Interest (AOI) within a specified time frame. Tasking includes:

* WorldView 2D imagery products
* WorldView 3D elevation products
* WorldView Radar data via Umbra

## Tasking API Version 2[​](#tasking-api-version-2 "Direct link to 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[​](#user-guides-and-examples "Direct link to User guides and examples")

| Page                                                                                    | Topic                                                                                        |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [WorldView 2D Tasking](/docs/tasking/guides/tasking-guide.md)                           | An overview of tasking imagery with WorldView 2D.                                            |
| [WorldView 3D Tasking](/docs/tasking/guides/worldview-3d-guide.md)                      | An overview of tasking elevation products with WorldView 3D.                                 |
| [WorldView Radar Tasking](/docs/tasking/guides/radar-guide.md)                          | An overview of radar tasking.                                                                |
| [Product Default Recipes](/docs/tasking/guides/pipeline-defaults.md)                    | The default settings for WorldView 2D imagery products.                                      |
| [Example: Request for FlexView 30 CM Color](/docs/tasking/guides/example-30cm-color.md) | A Worldview 2D FlexView tasking request example for 30 cm color, Ortho-Ready (OR2A) imagery. |
| [Example: Request for FastView 50 CM Color](/docs/tasking/guides/example-50cm-color.md) | A Worldview 2D FastView tasking request example for 50 cm System-Ready (1B) imagery.         |
| [Example: Request for WorldView 3D DSM](/docs/tasking/guides/example-worldview-3d.md)   | A Worldview 3D tasking request example for a Digital Surface Model.                          |
| [Example: Request for Umbra Radar](/docs/tasking/guides/example-umbra-sar.md)           | A WorldView Radar tasking request example for Umbra synthetic aperture radar imagery.        |
| [Validation and Errors](/docs/tasking/guides/validation.md)                             | Describes the validation checks and statuses in the Tasking workflow.                        |

## API reference[​](#api-reference "Direct link to API reference")

| Page                                                                                 | Topic                                                                                                                                                     |
| ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Tasking Request Limits](/docs/tasking/guides/request-limits.md)                     | The limitations on the number of tasking requests that can be placed in an hour.                                                                          |
| [Tasking End Use Codes](/docs/tasking/guides/end-use-codes.md)                       | Allowed values for the required "end use code" tasking parameter.                                                                                         |
| [Tasking Status and Errors](/docs/tasking/guides/tasking-status.md)                  | Status definitions and common error messages for failed statuses.                                                                                         |
| [`POST` Quote a Tasking Request](/docs/tasking/api/quote-a-tasking-request)          | Get a usage estimate quote for a tasking request before submitting.                                                                                       |
| [`POST` Submit FastView Tasking](/docs/tasking/api/submit-fast-view-tasking)         | Submit a WorldView 2D FlexView tasking request.                                                                                                           |
| [`POST` Submit FlexView Tasking](/docs/tasking/api/submit-flex-view-tasking)         | Submit a WorldView 2D FlexView tasking request.                                                                                                           |
| [`POST` Submit Umbra Tasking](/docs/tasking/api/submit-umbra-tasking)                | Submit a WorldView Radar tasking request from Umbra.                                                                                                      |
| [`POST` Check Feasibility](/docs/tasking/api/check-feasibility)                      | Check feasibility for FlexView tasking in a given time range                                                                                              |
| [`PATCH` Patch FlexView Tasking](/docs/tasking/api/patch-flex-view-tasking)          | Patch a FlexView tasking request to extend its end date.                                                                                                  |
| [`GET` Get the Status of a Tasking Request](/docs/tasking/api/get-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](/docs/tasking/api/list-tasking-requests)           | Lists all tasking requests for the account.                                                                                                               |
| [`POST` Cancel a Tasking Request](/docs/tasking/api/cancel-tasking-request)          | Cancel a tasking request before it's fulfilled. Requires the tasking ID.                                                                                  |

## V1 API legacy endpoints[​](#v1-api-legacy-endpoints "Direct link to 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](/docs/tasking/api/v1/get-a-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](/docs/tasking/api/v1/list-tasking-requests)           | Lists all tasking requests for the account.                                                                                                            |
| [`POST` Cancel a Tasking Request](/docs/tasking/api/v1/cancel-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.
