Datasets

List Datasets

get

List all datasets.

Authorizations
Query parameters
limitinteger · min: 1 · max: 1000OptionalDefault: 100
offsetintegerOptionalDefault: 0
Responses
200
Successful Response
application/json
get
GET /v1/datasets HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "dataset_id": "123e4567-e89b-12d3-a456-426614174000",
    "dataset_version_id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "type": "raster",
    "labels": [
      {
        "name": "text",
        "value": "text"
      }
    ],
    "created_at": "2025-07-19T19:19:52.505Z"
  }
]

Add Dataset

post
Authorizations
Body
any ofOptional
or
or
or
Responses
200
Successful Response
application/json
post
POST /v1/datasets HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 315

{
  "name": "my_dataset",
  "labels": {
    "name": "key",
    "value": "value"
  },
  "visualization_optimization": "auto",
  "pixel_info_optimizations": [
    "time"
  ],
  "type": "image",
  "urls": "gs://example-bucket/image_*.tif",
  "bands": [
    "band1",
    "band2"
  ],
  "filename_date_pattern": "%Y-%m-%d",
  "filename_band_pattern": {
    "band": "band1",
    "pattern": "image_*.tif"
  }
}
{
  "dataset_id": "123e4567-e89b-12d3-a456-426614174000"
}

Get Latest Dataset Version

get

Get the latest version of a dataset by dataset ID.

Authorizations
Path parameters
dataset_idstring · uuidRequired
Responses
200
Successful Response
application/json
get
GET /v1/datasets/{dataset_id}/latest HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "dataset_id": "123e4567-e89b-12d3-a456-426614174000",
  "dataset_version_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "type": "raster",
  "labels": [
    {
      "name": "text",
      "value": "text"
    }
  ],
  "variables": {
    "ANY_ADDITIONAL_PROPERTY": {
      "sampled_min": 1,
      "sampled_max": 1
    }
  },
  "created_at": "2025-07-19T19:19:52.505Z",
  "visualization_optimization": {
    "status": "not_started",
    "updated_at": "2025-07-19T19:19:52.505Z"
  },
  "pixel_info_optimizations": {
    "ANY_ADDITIONAL_PROPERTY": {
      "status": "not_started",
      "updated_at": "2025-07-19T19:19:52.505Z"
    }
  },
  "dynamic_tile_server": {
    "tile_url": "text",
    "pixel_url": "text",
    "min_zoom": 1,
    "max_zoom": 1
  },
  "optimized_tile_server": {
    "tile_url": "text",
    "pixel_url": "text",
    "min_zoom": 1,
    "max_zoom": 1
  }
}

Get Dataset Version By Id

get

Get a dataset version by version ID.

Authorizations
Path parameters
version_idstring · uuidRequired
Responses
200
Successful Response
application/json
get
GET /v1/dataset-versions/{version_id} HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "dataset_id": "123e4567-e89b-12d3-a456-426614174000",
  "dataset_version_id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "type": "raster",
  "labels": [
    {
      "name": "text",
      "value": "text"
    }
  ],
  "variables": {
    "ANY_ADDITIONAL_PROPERTY": {
      "sampled_min": 1,
      "sampled_max": 1
    }
  },
  "created_at": "2025-07-19T19:19:52.505Z",
  "visualization_optimization": {
    "status": "not_started",
    "updated_at": "2025-07-19T19:19:52.505Z"
  },
  "pixel_info_optimizations": {
    "ANY_ADDITIONAL_PROPERTY": {
      "status": "not_started",
      "updated_at": "2025-07-19T19:19:52.505Z"
    }
  },
  "dynamic_tile_server": {
    "tile_url": "text",
    "pixel_url": "text",
    "min_zoom": 1,
    "max_zoom": 1
  },
  "optimized_tile_server": {
    "tile_url": "text",
    "pixel_url": "text",
    "min_zoom": 1,
    "max_zoom": 1
  }
}
PreviousDataset TypesNextModels