Tasking Status
NOTE Tasking API V2 is in final development and review. This draft documentation is subject to change at any time.
This table describes the statuses that may be returned during the lifecycle of a tasking request.
- An "in progress" state indicates an interim step in the tasking lifecycle has been completed.
- A "final" state indicates the tasking request has ended and will not proceed further.
| Status | Description | State | Notification Level |
|---|---|---|---|
| INITIAL | The request was submitted to the Tasking API and has passed API validation. It will now be submitted to Vantor headquarters for acceptance. | start | INITIAL_FINAL, INTERMEDIATE |
| ACCEPTED | The request has passed validation by Vantor headquarters and will be scheduled for collection. | in progress | INITIAL_FINAL, INTERMEDIATE |
| AWAITING-COLLECTION | The tasking request has been scheduled and is awaiting collection. | in progress | INTERMEDIATE |
| IN-PRODUCTION | The image has been acquired and sent to the production system for processing. | in progress | INTERMEDIATE |
| PARTIAL-DELIVERY | Content has been produced and delivered for XX% of the AOI. | in progress | INTERMEDIATE |
| FULFILLED | All imagery collected for this request been successfully produced, delivered, and billed for greater than or equal to 99% of the total billable area. | final | INITIAL_FINAL, INTERMEDIATE, FINAL_ONLY |
| UNFULFILLED | Tasking request expired without fulfillment. | final | INITIAL_FINAL, INTERMEDIATE, FINAL_ONLY |
| PARTIALLY-FULFILLED | Content was collected, produced, delivered, and billed for some portion of the AOI, and at least part of the AOI will not be fulfilled. Only the delivered image(s) incur a charge. | final | INITIAL_FINAL, INTERMEDIATE, FINAL_ONLY |
| DENIED | The request has been denied by Vantor headquarters and will not be scheduled for collection. | final | INITIAL_FINAL, INTERMEDIATE, FINAL_ONLY |
| CANCELED | The owner of the tasking request sent a "cancel" request via the Tasking API. | final | INITIAL_FINAL, INTERMEDIATE, FINAL_ONLY |
| ERROR | An error has occurred, but the error type is not available. Contact support@vantor.com for more details. | final | INITIAL_FINAL, INTERMEDIATE, FINAL_ONLY |
Note: Fulfillment of a requested AOI may require more than one image to be collected. Each individual image is produced, delivered, and billed upon collection.
Additional attributes provide information related to status:
"tasking_status_transition_datetime": shows the time of the most recent status update"tasking_event_history": records a history of status updates and other events"status_details": provides latest status details for the tasking request
API status requests
To retrieve the status and status details for a tasking request, See GET a tasking request.
If you receive a status of CONTENT_PRODUCTION_SUCCESS or CONTENT_PRODUCTION_FAILURE, you can find more information about this event by looking up the details in the Ordering API. This API interface manages pipeline processing and content delivery.
See also:Validation Checks and Errors.