The successful
or captured
statuses mean you can download processing results from storage.
To get all assets from a specific job, call the Get specific STAC items endpoint with the following request body, using your job ID:
JSON
{
"filter": {
"args": [
{
"property": "job_id"
},
"68567134-27ad-7bd7-4b65-d61adb11fc78" // Replace with your job ID
],
"op": "="
}
}
The response will contain your job results listed in the features.assets
object. Retrieve the download links of the STAC assets you want to access.
JSON
{
"links": [], // Additional links
"type": "FeatureCollection",
"features": [
{
"assets": {
"072e661d_pan_68567134-27ad-7bd7-4b65-d61adb11fc78.tiff": {
"href": "https://api.up42.com/v2/assets/a0d443a2-41e8-4995", // The download link with an asset ID to use later
"title": "Pansharpened multispectral data",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"roles": ["pansharpened", "data", "multispectral"]
}
},
// Other parameters
"type": "Feature",
"stac_version": "1.0.0"
}
]
}
To download these assets one by one, call the Download an asset endpoint with the retrieved download link. For example:
HTTP
GET /v2/assets/ea36dee9-fed6-457e-8400-2c20ebd30f44 HTTP/1.1
Host: api.up42.com
Authorization: Bearer {token}
Shell
curl --location 'https://api.up42.com/v2/assets/ea36dee9-fed6-457e-8400-2c20ebd30f44' \
--header 'Authorization: Bearer {token}
If the request is successful, you will receive the requested asset as a response.
You can also generate a signed URL to download an asset without authentication. Call the Create a download URL endpoint with the asset ID as the path parameter. The generated URL is valid for 5 minutes and can be shared.