Skip to main content

Tasking Archive

Archive orders are used to request SkySat collects that are already in the archive. After an Archive order is created, the capture containing the requested SkySat collects is populated. SkySatCollects and related SkySatScenes can be downloaded using the usual flow, similar to regular Tasking orders.

note

Archive orders captures cannot be the target of Capture Review. Archive orders cannot be edited or cancelled.

Prerequisites to Archive Order Creation

Before creating an Archive order, you must have a list of desired SkySat collects, which intersect with the requested geometry. For the list of SkySat collects, use the following request to Data API:

curl --request POST --url 'https://api.planet.com/data/v1/quick-search' \
--header 'Accept: application/json' \
--header "Authorization: api-key $PL_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"filter": {
"type": "AndFilter",
"config": [
{
"type": "GeometryFilter",
"field_name": "geometry",
"config": {
"type": "Point",
"coordinates": [
47.817578706298946,
22.0761858843631
]
}
},
{
"type": "DateRangeFilter",
"field_name": "acquired",
"config": {
"gte": "2023-10-30T14:17:21.376Z",
"lte": "2024-10-30T14:17:21.377Z"
}
}
]
},
"item_types": [
"SkySatCollect"
]
}'

Archive Order Creation

The creation of a Archive order is done using a POST request to the Tasking API /orders endpoint. Create an Archive order using the following request example:

curl --request POST --url 'https://api.planet.com/tasking/v2/orders/' \
--header 'Accept: application/json' \
--header "Authorization: api-key $PL_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"name": "Archive Order 01",
"geometry": {
"type": "Point",
"coordinates": [
50.919139,
34.814306
]
},
"requested_item_ids": ["item_id_1", "item_id_2"],
"product": "Archive Tasking",
"pl_number": "$PL_CONTRACT_NUMBER"
}

The requested_item_ids field should contain the list of SkySat collects that you want to be included in the Archive order. They need to be available in Archive and intersect with the geometry of the order.