List collections
const url = 'https://api.satellitedata.net/v1/collections';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.satellitedata.net/v1/collectionsLists every collection live in the current phase, each with its band table, units, harmonization levels, mask source, extents and exact attribution string from schema v1. Collections that arrive in a later phase are absent until they launch. Free, anonymous and cached for 10 minutes.
Responses
Section titled “Responses”Collections; the example is shortened to two.
Collection list.
object
Collections live in this phase.
STAC collection with the schema v1 band table, units and attribution.
object
Always Collection.
STAC version.
STAC extension schema URIs.
Canonical collection id.
Collection title.
Collection description.
Keywords.
SPDX id, or “other” with a license link.
Data providers.
Provider.
object
Provider name.
Roles.
Provider URL.
Extents measured from the index.
object
Spatial extent.
object
Overall bbox first, then optional sub-boxes.
Temporal extent.
object
Intervals; an open end is null.
STAC summaries, such as platform and eo:cloud_cover ranges.
object
Band table from schema v1 (STAC 1.1 bands field). Empty on optical-sr, which lists common names in sdn:bands_common.
One band, from the schema v1 crosswalk.
object
Native band name, unique within the collection, for example B8A or SR_B5.
STAC eo common name, the cross-sensor key, for example nir08.
Band description.
Other names that resolve to this band within the collection.
Centre wavelength in micrometres.
Full width at half maximum in micrometres.
Native ground sample distance in metres.
Stored data type.
Raster:scale; value = scale x DN + offset.
Raster:offset for the newest product; see offset_rule when it depends on the item.
How the offset is chosen per item, when it is not constant.
Stored nodata value.
Default unit id from schema v1.
True when the band resolves on optical-sr.
Notes on the band, such as naming conflicts between catalogs.
Aliases from schema v1.
Collection alias.
object
Alias id accepted wherever a collection id is accepted.
Where the alias comes from, such as Sentinel Hub or Earth Search.
Alias group when one upstream id spans several collections.
CQL2 text filter that the alias implies.
Exact credit line to show with any output; responses replace {years} with acquisition years.
Units the collection can return.
Unit used when the request does not choose one.
Harmonization levels the collection supports.
Harmonization level used when the request does not choose one.
Derived bands such as mask, mask_class and dataMask.
Cloud-mask source.
Mask classes the source can detect. A class missing here is not detectable, not absent.
True for optical-sr, which searches its member collections.
Member collections of a virtual collection.
Common band names that resolve on a virtual collection.
Tile zoom range.
object
Lowest zoom served from the full archive.
Highest zoom served.
Links, including items, queryables, license and the schema.
A STAC and OGC API link object.
object
Link target.
Relation type, such as self, root, parent, next, prev, items, queryables, tiles or license.
Media type of the target.
Human-readable title.
HTTP method for the link, GET unless stated. Paging POST /v1/search uses POST.
Request body to send with a POST link, used for the next page of POST /v1/search.
object
When true the client merges body into the previous request body.
Links.
A STAC and OGC API link object.
object
Link target.
Relation type, such as self, root, parent, next, prev, items, queryables, tiles or license.
Media type of the target.
Human-readable title.
HTTP method for the link, GET unless stated. Paging POST /v1/search uses POST.
Request body to send with a POST link, used for the next page of POST /v1/search.
object
When true the client merges body into the previous request body.
Number of collections.
Number returned.
Example
{ "collections": [ { "type": "Collection", "stac_version": "1.1.0", "stac_extensions": [ "https://stac-extensions.github.io/eo/v2.0.0/schema.json", "https://stac-extensions.github.io/raster/v2.0.0/schema.json", "https://stac-extensions.github.io/classification/v2.0.0/schema.json" ], "id": "sentinel-2-l2a", "title": "Sentinel-2 L2A", "description": "Sentinel-2 MSI bottom-of-atmosphere reflectance from Sen2Cor, Collection-1 COGs indexed from Earth Search v1.", "keywords": [ "sentinel-2", "reflectance", "copernicus" ], "license": "other", "providers": [ { "name": "European Space Agency", "roles": [ "licensor", "producer" ], "url": "https://sentinels.copernicus.eu/" }, { "name": "Element 84", "roles": [ "host" ], "url": "https://element84.com/" }, { "name": "satellitedata.net", "roles": [ "processor" ], "url": "https://satellitedata.net/" } ], "extent": { "spatial": { "bbox": [ [ -180, -56, 180, 84 ] ] }, "temporal": { "interval": [ [ "2015-07-04T00:00:00Z", null ] ] } }, "summaries": { "platform": [ "sentinel-2a", "sentinel-2b", "sentinel-2c" ], "eo:cloud_cover": { "minimum": 0, "maximum": 100 } }, "bands": [ { "name": "B04", "common_name": "red", "description": null, "center_wavelength": 0.6646, "full_width_half_max": 0.031, "gsd": 10, "data_type": "uint16", "scale": 0.0001, "offset": -0.1, "nodata": 0, "unit": "REFLECTANCE", "aliases": [ "red", "B4" ], "cross_sensor": true, "offset_rule": "offset = BOA_ADD_OFFSET / QUANTIFICATION_VALUE (-1000 / 10000 = -0.1) when s2:processing_baseline >= 04.00, including Collection-1 reprocessed 2015-2021 scenes; 0 before 04.00. Chosen per item from s2:processing_baseline, never from acquisition date." }, { "name": "B08", "common_name": "nir", "description": null, "center_wavelength": 0.8328, "full_width_half_max": 0.118, "gsd": 10, "data_type": "uint16", "scale": 0.0001, "offset": -0.1, "nodata": 0, "unit": "REFLECTANCE", "aliases": [ "nir", "NIR_Broad", "B8" ], "cross_sensor": false, "offset_rule": "offset = BOA_ADD_OFFSET / QUANTIFICATION_VALUE (-1000 / 10000 = -0.1) when s2:processing_baseline >= 04.00, including Collection-1 reprocessed 2015-2021 scenes; 0 before 04.00. Chosen per item from s2:processing_baseline, never from acquisition date.", "notes": "Broad NIR, the only 10 m NIR band. No Landsat equivalent and no HLS bandpass coefficient. Cross-sensor NIR is nir08 (B8A)." }, { "name": "B8A", "common_name": "nir08", "description": null, "center_wavelength": 0.8647, "full_width_half_max": 0.02, "gsd": 20, "data_type": "uint16", "scale": 0.0001, "offset": -0.1, "nodata": 0, "unit": "REFLECTANCE", "aliases": [ "nir08", "NIR_Narrow" ], "cross_sensor": true, "offset_rule": "offset = BOA_ADD_OFFSET / QUANTIFICATION_VALUE (-1000 / 10000 = -0.1) when s2:processing_baseline >= 04.00, including Collection-1 reprocessed 2015-2021 scenes; 0 before 04.00. Chosen per item from s2:processing_baseline, never from acquisition date.", "notes": "Matches Landsat OLI B5. Planetary Computer labels this band rededge; satellitedata.net follows Earth Search." } ], "sdn:aliases": [ { "id": "S2L2A", "source": "Sentinel Hub legacy id" }, { "id": "sentinel-2-c1-l2a", "source": "Earth Search v1" }, { "id": "SENTINEL2_L2A", "source": "CDSE openEO" }, { "id": "COPERNICUS/S2_SR_HARMONIZED", "source": "Google Earth Engine" } ], "sdn:attribution": "Contains modified Copernicus Sentinel data {years}", "sdn:units": [ "REFLECTANCE", "DN" ], "sdn:default_units": "REFLECTANCE", "sdn:harmonize_levels": [ "none", "offset_removed", "bandpass_adjusted" ], "sdn:default_harmonize": "offset_removed", "sdn:pseudo_bands": [ "mask", "mask_class", "dataMask", "cloud_probability" ], "sdn:mask_source": "scl", "sdn:mask_capabilities": [ "nodata", "saturated_defective", "cloud", "cloud_shadow", "cirrus", "snow_ice", "water", "dark_terrain_shadow", "unclassified", "clear", "cloud_adjacent" ], "sdn:virtual": false, "sdn:zoom": { "min": 8, "max": 15 }, "links": [ { "href": "https://api.satellitedata.net/v1/collections/sentinel-2-l2a", "rel": "self", "type": "application/json" }, { "href": "https://api.satellitedata.net/v1", "rel": "root", "type": "application/json" }, { "href": "https://api.satellitedata.net/v1/collections/sentinel-2-l2a/items", "rel": "items", "type": "application/geo+json" }, { "href": "https://api.satellitedata.net/v1/collections/sentinel-2-l2a/queryables", "rel": "http://www.opengis.net/def/rel/ogc/1.0/queryables", "type": "application/schema+json" }, { "href": "https://sentinels.copernicus.eu/documents/247904/690755/Sentinel_Data_Legal_Notice", "rel": "license", "title": "Legal notice on the use of Copernicus Sentinel data" }, { "href": "https://api.satellitedata.net/v1/schema", "rel": "describedby", "type": "application/json", "title": "Schema v1" } ] }, { "type": "Collection", "stac_version": "1.1.0", "id": "optical-sr", "title": "Virtual optical surface reflectance", "description": "Searches and mosaics Sentinel-2 L2A, Landsat 4-9 Level-2 and HLS together, resolves common band names per item, removes duplicate observations and reports the harmonization applied to each scene.", "license": "other", "extent": { "spatial": { "bbox": [ [ -180, -90, 180, 90 ] ] }, "temporal": { "interval": [ [ "1982-08-22T00:00:00Z", null ] ] } }, "bands": [], "sdn:aliases": [], "sdn:attribution": "Composed per response from the members used.", "sdn:units": [ "REFLECTANCE", "DN" ], "sdn:default_units": "REFLECTANCE", "sdn:harmonize_levels": [ "none", "offset_removed", "bandpass_adjusted", "nbar" ], "sdn:default_harmonize": "bandpass_adjusted", "sdn:pseudo_bands": [ "mask", "mask_class", "dataMask" ], "sdn:virtual": true, "sdn:members": [ "sentinel-2-l2a", "landsat-ot-l2", "landsat-etm-l2", "landsat-tm-l2", "hls" ], "sdn:bands_common": [ "blue", "green", "red", "nir08", "swir16", "swir22" ], "sdn:zoom": { "min": 8, "max": 14 }, "links": [ { "href": "https://api.satellitedata.net/v1/collections/optical-sr", "rel": "self", "type": "application/json" }, { "href": "https://api.satellitedata.net/v1/collections/optical-sr/items", "rel": "items", "type": "application/geo+json" } ] } ], "links": [ { "href": "https://api.satellitedata.net/v1/collections", "rel": "self", "type": "application/json" }, { "href": "https://api.satellitedata.net/v1", "rel": "root", "type": "application/json" } ], "numberMatched": 2, "numberReturned": 2}Headers
Section titled “Headers”Request id for support and logs.
Example
01JQ7Z3M8R5V2W6X9Y0A1B2C3DEntity tag; includes the render version.
Example
"r3-9f2c1a"Caching policy for CloudFront and browsers.
Example
public, max-age=3600, s-maxage=2592000, stale-if-error=604800A per-minute, concurrency, monthly or per-IP limit was hit. Retry-After says when to retry.
RFC 9457 problem details. Every 4xx and 5xx response uses this shape with media type application/problem+json. The type URL opens a documentation page that explains the cause and the fix.
object
URL of the documentation page for this problem type, stable for the life of /v1.
Short summary of the problem type. It does not change between occurrences.
HTTP status code, repeated for clients that lose the status line.
Explanation specific to this occurrence, written for a developer.
Path of the request that failed.
Machine-readable problem code; equals the last path segment of type.
Request id, also sent in X-Request-Id. Quote it in support requests.
Field-level validation failures, present on 400 and 422.
One field-level failure.
object
JSON Pointer (RFC 6901) into the request body, or the query parameter name.
What is wrong with that member.
Seconds until the request can succeed; equals the Retry-After header.
The limit that was hit and the value requested, for example maxWidth and requestedWidth.
object
Units the request would have cost, computed before execution.
OAuth 2.0 error code (RFC 6749 section 5.2). Present only on /oauth/token responses.
OAuth 2.0 error description. Present only on /oauth/token responses.
Copy of detail for openEO clients, which read message. Present only on /v1/openeo routes.
Example
{ "type": "https://docs.satellitedata.net/problems/rate-limited", "title": "Rate limit exceeded", "status": 429, "detail": "This key spent 300 of its 300 units in the current minute.", "instance": "/v1/process", "code": "rate-limited", "requestId": "01JQ7Z3M8R5V2W6X9Y0A1B2C3D", "retryAfter": 17, "limits": { "unitsPerMinute": 300, "unitsSpentThisMinute": 300 }}Headers
Section titled “Headers”Request id for support and logs.
Example
01JQ7Z3M8R5V2W6X9Y0A1B2C3DSeconds to wait before retrying.
Example
17Remaining units and seconds to reset in the current window (IETF RateLimit header draft).
Example
"units";r=287;t=41Quota policy of the caller (IETF RateLimit header draft).
Example
"units";q=300;w=60An unexpected server error. No units are charged.
RFC 9457 problem details. Every 4xx and 5xx response uses this shape with media type application/problem+json. The type URL opens a documentation page that explains the cause and the fix.
object
URL of the documentation page for this problem type, stable for the life of /v1.
Short summary of the problem type. It does not change between occurrences.
HTTP status code, repeated for clients that lose the status line.
Explanation specific to this occurrence, written for a developer.
Path of the request that failed.
Machine-readable problem code; equals the last path segment of type.
Request id, also sent in X-Request-Id. Quote it in support requests.
Field-level validation failures, present on 400 and 422.
One field-level failure.
object
JSON Pointer (RFC 6901) into the request body, or the query parameter name.
What is wrong with that member.
Seconds until the request can succeed; equals the Retry-After header.
The limit that was hit and the value requested, for example maxWidth and requestedWidth.
object
Units the request would have cost, computed before execution.
OAuth 2.0 error code (RFC 6749 section 5.2). Present only on /oauth/token responses.
OAuth 2.0 error description. Present only on /oauth/token responses.
Copy of detail for openEO clients, which read message. Present only on /v1/openeo routes.
Example
{ "type": "https://docs.satellitedata.net/problems/internal", "title": "Internal error", "status": 500, "detail": "The request failed on our side and was logged. No units were charged.", "instance": "/v1/process", "code": "internal", "requestId": "01JQ7Z3M8R5V2W6X9Y0A1B2C3D"}Headers
Section titled “Headers”Request id for support and logs.
Example
01JQ7Z3M8R5V2W6X9Y0A1B2C3D