Task products

GET tasking/v1/tasks/${taskID}/products

GET tasking/v1/tasks/${taskID}/products/${productType}

You can download your SAR Products from the Tasking API if the task status is FULFILLED or DONE.

  • FULFILLED — standard products are available for download within 8 hours of the acqusition time (standard SLA is 8 hours).

  • DONE — all products are available for download, including non-standard products. Non-standard products are included only if specified when creating a task).

Standard products

Read more about what these products offer in the ICEYE Product Specification.

Imaging Mode Standard Product Types Non-Standard Product Types

Scan

GRD

NA

Strip

GRD, SLC

SICD, SIDD

Spot

GRD, SLC

SICD, SIDD

Spot Fine

GRD, SLC

SICD, SIDD

Spot Extended Area

GRD, SLC

SICD, SIDD

Dwell

GRD, SLC, CSI, VID

SICD, SIDD

Dwell Fine

GRD, SLC, CSI, VID

SICD, SIDD

Get products

Example

Request

To get the download details for all product types, enter the following curl command, remembering to replace the ${VARNAME} variables with the appropriate values:

curl --location "${API_BASE_URL}/api/tasking/v1/tasks/${taskID}/products" \
--header "Accept: application/json, application/problem+json" \
--header "Authorization: Bearer ${API_ACCESS_TOKEN}"

Response

On success, the response returns a 200 status code and a JSON object containing list of Products details, including a list of all its assets and safe, pre-signed download URLs.

Download URLs expire in 1 hour. Do not store the URLs for long term access. 
[
  {
    "type": "GRD",
    "assets": [
      {
        "contentType": "application/vnd.google-earth.kml+xml",
        "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-111",
        "title": "Quicklook metadata file"
      },
      {
        "contentType": "image/png",
        "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-222",
        "title": "Quicklook png file"
      },
      {
        "contentType": "application/vnd.google-earth.kmz",
        "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-333",
        "title": "Quickortho kmz file"
      },
      {
        "contentType": "application/vnd.google-earth.kml+xml",
        "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-444",
        "title": "Thumbnail metadata file"
      }
    ]
  },
  {
    "type": "SLC",
    "assets": [
      {
        "contentType": "image/png",
        "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-555",
        "title": "Thumbnail png file"
      },
      {
        "contentType": "image/tiff; application=geotiff",
        "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-666",
        "title": "SLC data file"
      },
      {
        "contentType": "application/xml",
        "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-777",
        "title": "SLC metadata file"
      },
      {
        "contentType": "image/tiff; application=geotiff",
        "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-888",
        "title": "Quickortho tif file"
      },
      {
        "contentType": "application/json",
        "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-999",
        "title": "Thumbnail json file"
      }
    ]
  }
]

Get products by type

Example

Request

To get the download details for products of type GRD, enter the following curl command, remembering to replace the ${VARNAME} variables with the appropriate values:

curl --location "${API_BASE_URL}/api/tasking/v1/tasks/${taskID}/products/GRD" \
--header "Accept: application/json, application/problem+json" \
--header "Authorization: Bearer ${API_ACCESS_TOKEN}"

Response

On success, the response returns a 200 status code and a JSON object containing the Product details, including a list of all its assets and safe, pre-signed download URLs.

Download URLs expire in 1 hour. Do not store the URLs for long term access. 
{
  "type": "GRD",
  "assets": [
    {
      "contentType": "application/vnd.google-earth.kml+xml",
      "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-111",
      "title": "Quicklook metadata file"
    },
    {
      "contentType": "image/png",
      "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-222",
      "title": "Quicklook png file"
    },
    {
      "contentType": "application/vnd.google-earth.kmz",
      "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-333",
      "title": "Quickortho kmz file"
    },
    {
      "contentType": "application/vnd.google-earth.kml+xml",
      "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-444",
      "title": "Thumbnail metadata file"
    },
    {
      "contentType": "image/png",
      "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-555",
      "title": "Thumbnail png file"
    },
    {
      "contentType": "image/tiff; application=geotiff",
      "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-666",
      "title": "GRD data file"
    },
    {
      "contentType": "application/xml",
      "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-777",
      "title": "GRD metadata file"
    },
    {
      "contentType": "image/tiff; application=geotiff",
      "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-888",
      "title": "Quickortho tif file"
    },
    {
      "contentType": "application/json",
      "downloadURL": "https://ZZZZ.cloudfront.net/XXX-XXX-XXX-999",
      "title": "Thumbnail json file"
    }
  ]
}