Data products

Get information about UP42 data products.


Overview

Data products are a type of imagery with a specific geometric and radiometric processing level and file format. All collections have different data products corresponding to their technical specifications.

See data products

To see a list of all available data products, call the /data-products endpoint.

Request

GET /data-products HTTP/1.1
Host: api.up42.com
Query parameterOverview
collectionNamestring
The name of the geospatial collection.
is_integratedstring
Whether it is integrated in the UP42 API. The default value is true.

You can order non-integrated data by contacting the Operations team.

Response


See response example
{
  "data": [
    {
      "id": "7131f727-cdbb-46d4-a1e7-77ac38b7bd02",
      "productConfiguration": {
        "host": {
          "name": "nearspacelabs",
          "title": "Near Space Labs",
          "description": "A commercial stratospheric imagery provider offering analytics-ready, very high-resolution images captured from sub-daily flights.",
          "isIntegrated": true,
          "isCommercial": true,
          "createdAt": "2022-02-02T11:06:09.581868Z",
          "updatedAt": "2022-02-02T11:06:09.581868Z"
        },
        "hostName": "nearspacelabs",
        "title": "Display Full Scene",
        "description": "Monoscopic imagery with fast non-local means denoising, sigmoidal contrast and white balancing, image-based atmospheric correction, and georeferencing accuracy of 10m CE90.",
        "id": "eb2ca5fd-2880-43b0-91c9-b6d164ec3973",
        "configuration": {},
        "isIntegrated": true,
        "createdAt": "2022-02-10T15:38:18.598392Z",
        "updatedAt": "2022-02-10T15:38:18.598392Z"
      },
      "productConfigurationId": "eb2ca5fd-2880-43b0-91c9-b6d164ec3973",
      "collection": {
        "name": "nsl-30cm",
        "title": "Near Space Labs",
        "description": "Analytics-ready, 30cm very high resolution stratospheric images captured from sub-daily flights.",
        "type": "ARCHIVE",
        "restricted": false,
        "host": {
          "name": "nearspacelabs",
          "title": "Near Space Labs",
          "description": "A commercial stratospheric imagery provider offering analytics-ready, very high-resolution images captured from sub-daily flights.",
          "isIntegrated": true,
          "isCommercial": true,
          "createdAt": "2022-02-02T11:06:09.581868Z",
          "updatedAt": "2022-02-02T11:06:09.581868Z"
        },
        "hostName": "nearspacelabs",
        "producer": {
          "name": "near-space-labs",
          "title": "Near Space Labs",
          "description": "A commercial stratospheric imagery provider offering analytics-ready, very high-resolution images captured from sub-daily flights.",
          "isIntegrated": true,
          "createdAt": "2022-02-02T11:06:09.581868Z",
          "updatedAt": "2022-02-02T11:06:09.581868Z"
        },
        "producerName": "near-space-labs",
        "isIntegrated": true,
        "isOptical": true,
        "resolution": "VERY_HIGH",
        "createdAt": "2022-02-02T11:06:09.581868Z",
        "updatedAt": "2023-05-15T21:01:34.132486Z"
      },
      "collectionName": "nsl-30cm",
      "isIntegrated": true,
      "createdAt": "2022-02-10T15:38:18.804420Z",
      "updatedAt": "2022-02-10T15:38:18.804420Z"
    }
  ],
  "error": null
}

ParameterOverview
data.idstring
The data product ID.
data.productConfigurationobject
The product configuration of the data product.
data.collectionobject
Information about the collection.
data.isIntegratedboolean
Whether the data product is integrated in the UP42 API.

You can order non-integrated data products by contacting the Operations team.
data.createdAtstring
The timestamp when the the data product was created.
data.updatedAtstring
The timestamp when the the data product was updated.

See a particular data product

To see information about one data product, call the /data-products/{data_product_id} endpoint with a specific data product ID as a path parameter.

Request

GET /data-products/{data_product_id} HTTP/1.1
Host: api.up42.com

Response

The response is an object from the /data-products data array.

See response example
{
  "data": {
    "id": "7131f727-cdbb-46d4-a1e7-77ac38b7bd02",
    "productConfiguration": {
      "host": {
        "name": "nearspacelabs",
        "title": "Near Space Labs",
        "description": "A commercial stratospheric imagery provider offering analytics-ready, very high-resolution images captured from sub-daily flights.",
        "isIntegrated": true,
        "isCommercial": true,
        "createdAt": "2022-02-02T11:06:09.581868Z",
        "updatedAt": "2022-02-02T11:06:09.581868Z"
      },
      "hostName": "nearspacelabs",
      "title": "Display Full Scene",
      "description": "Monoscopic imagery with fast non-local means denoising,...",
      "id": "eb2ca5fd-2880-43b0-91c9-b6d164ec3973",
      "configuration": {},
      "isIntegrated": true,
      "createdAt": "2022-02-10T15:38:18.598392Z",
      "updatedAt": "2022-02-10T15:38:18.598392Z"
    },
    "productConfigurationId": "eb2ca5fd-2880-43b0-91c9-b6d164ec3973",
    "collection": {
      "name": "nsl-30cm",
      "title": "Near Space Labs",
      "description": "Analytics-ready, 30cm very high resolution stratospheric images captured from sub-daily flights.",
      "type": "ARCHIVE",
      "restricted": false,
      "host": {
        "name": "nearspacelabs",
        "title": "Near Space Labs",
        "description": "A commercial stratospheric imagery provider offering analytics-ready, very high-resolution images captured from sub-daily flights.",
        "isIntegrated": true,
        "isCommercial": true,
        "createdAt": "2022-02-02T11:06:09.581868Z",
        "updatedAt": "2022-02-02T11:06:09.581868Z"
      },
      "hostName": "nearspacelabs",
      "producer": {
        "name": "near-space-labs",
        "title": "Near Space Labs",
        "description": "A commercial stratospheric imagery provider offering analytics-ready, very high-resolution images captured from sub-daily flights.",
        "isIntegrated": true,
        "createdAt": "2022-02-02T11:06:09.581868Z",
        "updatedAt": "2022-02-02T11:06:09.581868Z"
      },
      "producerName": "near-space-labs",
      "isIntegrated": true,
      "isOptical": true,
      "resolution": "VERY_HIGH",
      "createdAt": "2022-02-02T11:06:09.581868Z",
      "updatedAt": "2023-05-15T21:01:34.132486Z"
    },
    "collectionName": "nsl-30cm",
    "isIntegrated": true,
    "createdAt": "2022-02-10T15:38:18.804420Z",
    "updatedAt": "2022-02-10T15:38:18.804420Z"
  },
  "error": null
}