Getting Started Authentication Unified Search Scene Details Asset Resolver Processing Data Sources SDKs

Scene Details

Scene Details API

Retrieve complete STAC metadata for a single satellite scene by its provider-scoped ID. Use this endpoint to get full property details, geometry, and asset download links for a known scene.

Endpoint

GET/api/v1/scenes/{id}

Requires authentication via Bearer token.

Scene ID Format

Scene IDs in ASTRA OS use a provider-scoped format to ensure uniqueness across data sources:

ID Format

provider:original_id

Provider	Example ID
Sentinel-2 (Copernicus)	sentinel-2:S2B_MSIL2A_20250115T184929_N0511_R070_T10SEG_20250115T213616
Landsat (USGS)	landsat:LC09_L2SP_044034_20250110_20250112_02_T1
Planetary Computer	planetary-computer:S2B_MSIL2A_20250115T184929_R070_T10SEG

The id field returned in search results is already in this format and can be passed directly to this endpoint.

Example Request

cURL

terminal

curl "https://astraos.cloud/api/v1/scenes/sentinel-2:S2B_MSIL2A_20250115T184929" \
  -H "Authorization: Bearer astra_sk_live_your_key_here"

Python

scene_detail.py

import requests
scene_id = "sentinel-2:S2B_MSIL2A_20250115T184929"
response = requests.get(
    f"https://astraos.cloud/api/v1/scenes/{scene_id}",
    headers={"Authorization": "Bearer astra_sk_live_your_key_here"},
)
scene = response.json()
print(f"Platform: {scene[&"color: #6b7280">#39;properties&#39;][&#39;platform&#39;]}")
print(f"Cloud cover: {scene[&"color: #6b7280">#39;properties&#39;][&#39;eo:cloud_cover&#39;]}%")
print(f"Available bands: {list(scene[&"color: #6b7280">#39;assets&#39;].keys())}")

JavaScript

scene_detail.js

const sceneId = "sentinel-2:S2B_MSIL2A_20250115T184929";
const res = await fetch(
  `https:"color: #6b7280">//astraos.cloud/api/v1/scenes/${sceneId}`,
  {
    headers: { Authorization: "Bearer astra_sk_live_your_key_here" },
  }
);
const scene = await res.json();
console.log("Platform:", scene.properties.platform);
console.log("Cloud cover:", scene.properties["eo:cloud_cover"] + "%");
console.log("Available bands:", Object.keys(scene.assets));

Response: STAC Item

The response is a single STAC Item conforming to the STAC 1.0.0 specification. It includes complete geometry, all available properties, and direct asset download URLs.

stac_item.json

1{
2  "type": "Feature",
3  "stac_version": "1.0.0",
4  "stac_extensions": [
5    "https://stac-extensions.github.io/eo/v1.1.0/schema.json",
6    "https://stac-extensions.github.io/projection/v1.1.0/schema.json",
7    "https://stac-extensions.github.io/view/v1.0.0/schema.json"
8  ],
9  "id": "sentinel-2:S2B_MSIL2A_20250115T184929",
10  "geometry": {
11    "type": "Polygon",
12    "coordinates": [[[-122.52,37.48],[-121.98,37.48],[-121.98,38.02],[-122.52,38.02],[-122.52,37.48]]]
13  },
14  "bbox": [-122.52, 37.48, -121.98, 38.02],
15  "properties": {
16    "datetime": "2025-01-15T18:49:29Z",
17    "created": "2025-01-15T22:00:00Z",
18    "updated": "2025-01-15T22:00:00Z",
19    "eo:cloud_cover": 8.2,
20    "platform": "sentinel-2b",
21    "constellation": "sentinel-2",
22    "instruments": ["msi"],
23    "gsd": 10,
24    "proj:epsg": 32610,
25    "view:sun_azimuth": 162.3,
26    "view:sun_elevation": 28.1,
27    "astra:provider": "copernicus",
28    "astra:collection": "sentinel-2-l2a"
29  },
30  "assets": {
31    "B02": {
32      "href": "https://storage.astraos.cloud/scenes/.../B02.tif",
33      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
34      "title": "Blue (B02) - 10m",
35      "eo:bands": [{ "name": "B02", "common_name": "blue", "center_wavelength": 0.49 }]
36    },
37    "B03": {
38      "href": "https://storage.astraos.cloud/scenes/.../B03.tif",
39      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
40      "title": "Green (B03) - 10m",
41      "eo:bands": [{ "name": "B03", "common_name": "green", "center_wavelength": 0.56 }]
42    },
43    "B04": {
44      "href": "https://storage.astraos.cloud/scenes/.../B04.tif",
45      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
46      "title": "Red (B04) - 10m",
47      "eo:bands": [{ "name": "B04", "common_name": "red", "center_wavelength": 0.665 }]
48    },
49    "B08": {
50      "href": "https://storage.astraos.cloud/scenes/.../B08.tif",
51      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
52      "title": "NIR (B08) - 10m",
53      "eo:bands": [{ "name": "B08", "common_name": "nir", "center_wavelength": 0.842 }]
54    },
55    "visual": {
56      "href": "https://storage.astraos.cloud/scenes/.../visual.tif",
57      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
58      "title": "True Color Composite (RGB)"
59    },
60    "thumbnail": {
61      "href": "https://storage.astraos.cloud/scenes/.../thumbnail.png",
62      "type": "image/png",
63      "title": "Thumbnail"
64    }
65  },
66  "links": [
67    { "rel": "self", "href": "https://astraos.cloud/api/v1/scenes/sentinel-2:S2B_MSIL2A_20250115T184929" },
68    { "rel": "parent", "href": "https://astraos.cloud/api/v1/search" },
69    { "rel": "root", "href": "https://astraos.cloud/api/v1" }
70  ]
71}

Error Responses

Status	Code	Description
404	SCENE_NOT_FOUND	No scene with the given ID exists. Verify the ID format and that the scene has not been archived.
400	INVALID_ID_FORMAT	The ID does not match the expected `provider:original_id` format.
401	UNAUTHORIZED	Missing or invalid API key. See Authentication.

← Unified Search Asset Resolver →

Scene ID Format

Scene IDs in ASTRA OS use a provider-scoped format to ensure uniqueness across data sources:

ID Format

provider:original_id

Provider	Example ID
Sentinel-2 (Copernicus)	sentinel-2:S2B_MSIL2A_20250115T184929_N0511_R070_T10SEG_20250115T213616
Landsat (USGS)	landsat:LC09_L2SP_044034_20250110_20250112_02_T1
Planetary Computer	planetary-computer:S2B_MSIL2A_20250115T184929_R070_T10SEG

The id field returned in search results is already in this format and can be passed directly to this endpoint.

Example Request

cURL

terminal

curl "https://astraos.cloud/api/v1/scenes/sentinel-2:S2B_MSIL2A_20250115T184929" \
  -H "Authorization: Bearer astra_sk_live_your_key_here"

Python

scene_detail.py

import requests
scene_id = "sentinel-2:S2B_MSIL2A_20250115T184929"
response = requests.get(
    f"https://astraos.cloud/api/v1/scenes/{scene_id}",
    headers={"Authorization": "Bearer astra_sk_live_your_key_here"},
)
scene = response.json()
print(f"Platform: {scene[&"color: #6b7280">#39;properties&#39;][&#39;platform&#39;]}")
print(f"Cloud cover: {scene[&"color: #6b7280">#39;properties&#39;][&#39;eo:cloud_cover&#39;]}%")
print(f"Available bands: {list(scene[&"color: #6b7280">#39;assets&#39;].keys())}")

JavaScript

scene_detail.js

const sceneId = "sentinel-2:S2B_MSIL2A_20250115T184929";
const res = await fetch(
  `https:"color: #6b7280">//astraos.cloud/api/v1/scenes/${sceneId}`,
  {
    headers: { Authorization: "Bearer astra_sk_live_your_key_here" },
  }
);
const scene = await res.json();
console.log("Platform:", scene.properties.platform);
console.log("Cloud cover:", scene.properties["eo:cloud_cover"] + "%");
console.log("Available bands:", Object.keys(scene.assets));

Response: STAC Item

The response is a single STAC Item conforming to the STAC 1.0.0 specification. It includes complete geometry, all available properties, and direct asset download URLs.

stac_item.json

1{
2  "type": "Feature",
3  "stac_version": "1.0.0",
4  "stac_extensions": [
5    "https://stac-extensions.github.io/eo/v1.1.0/schema.json",
6    "https://stac-extensions.github.io/projection/v1.1.0/schema.json",
7    "https://stac-extensions.github.io/view/v1.0.0/schema.json"
8  ],
9  "id": "sentinel-2:S2B_MSIL2A_20250115T184929",
10  "geometry": {
11    "type": "Polygon",
12    "coordinates": [[[-122.52,37.48],[-121.98,37.48],[-121.98,38.02],[-122.52,38.02],[-122.52,37.48]]]
13  },
14  "bbox": [-122.52, 37.48, -121.98, 38.02],
15  "properties": {
16    "datetime": "2025-01-15T18:49:29Z",
17    "created": "2025-01-15T22:00:00Z",
18    "updated": "2025-01-15T22:00:00Z",
19    "eo:cloud_cover": 8.2,
20    "platform": "sentinel-2b",
21    "constellation": "sentinel-2",
22    "instruments": ["msi"],
23    "gsd": 10,
24    "proj:epsg": 32610,
25    "view:sun_azimuth": 162.3,
26    "view:sun_elevation": 28.1,
27    "astra:provider": "copernicus",
28    "astra:collection": "sentinel-2-l2a"
29  },
30  "assets": {
31    "B02": {
32      "href": "https://storage.astraos.cloud/scenes/.../B02.tif",
33      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
34      "title": "Blue (B02) - 10m",
35      "eo:bands": [{ "name": "B02", "common_name": "blue", "center_wavelength": 0.49 }]
36    },
37    "B03": {
38      "href": "https://storage.astraos.cloud/scenes/.../B03.tif",
39      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
40      "title": "Green (B03) - 10m",
41      "eo:bands": [{ "name": "B03", "common_name": "green", "center_wavelength": 0.56 }]
42    },
43    "B04": {
44      "href": "https://storage.astraos.cloud/scenes/.../B04.tif",
45      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
46      "title": "Red (B04) - 10m",
47      "eo:bands": [{ "name": "B04", "common_name": "red", "center_wavelength": 0.665 }]
48    },
49    "B08": {
50      "href": "https://storage.astraos.cloud/scenes/.../B08.tif",
51      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
52      "title": "NIR (B08) - 10m",
53      "eo:bands": [{ "name": "B08", "common_name": "nir", "center_wavelength": 0.842 }]
54    },
55    "visual": {
56      "href": "https://storage.astraos.cloud/scenes/.../visual.tif",
57      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
58      "title": "True Color Composite (RGB)"
59    },
60    "thumbnail": {
61      "href": "https://storage.astraos.cloud/scenes/.../thumbnail.png",
62      "type": "image/png",
63      "title": "Thumbnail"
64    }
65  },
66  "links": [
67    { "rel": "self", "href": "https://astraos.cloud/api/v1/scenes/sentinel-2:S2B_MSIL2A_20250115T184929" },
68    { "rel": "parent", "href": "https://astraos.cloud/api/v1/search" },
69    { "rel": "root", "href": "https://astraos.cloud/api/v1" }
70  ]
71}

Status

Code

Description

404

SCENE_NOT_FOUND

No scene with the given ID exists. Verify the ID format and that the scene has not been archived.

400

INVALID_ID_FORMAT

The ID does not match the expected provider:original_id format.

401

UNAUTHORIZED

Missing or invalid API key. See Authentication.