One item

GET

/v1/collections/{collectionId}/items/{itemId}

const url = 'https://api.satellitedata.net/v1/collections/sentinel-2-l2a/items/S2A_T31TCF_20260829T105044_L2A';
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/collections/sentinel-2-l2a/items/S2A_T31TCF_20260829T105044_L2A

One item, links rewritten, with a preview link.

Parameters

Path Parameters

collectionId

required

string

/^[A-Za-z0-9_.-]+$/

Collection id or alias without a slash, for example sentinel-2-l2a or S2L2A.

Example

sentinel-2-l2a

itemId

required

string

Native item id.

Example

S2A_T31TCF_20260829T105044_L2A

Responses

200

The item.

application/geo+json

STAC item.

object

type

required

Always Feature.

string

Allowed value: Feature

stac_version

required

STAC version.

string

stac_extensions

Extensions.

Array<string>

required

Native upstream item id.

string

collection

Collection id.

string

geometry

required

One of:

object
null

A GeoJSON geometry.

object

type

required

GeoJSON geometry type.

string

Allowed values: Point MultiPoint LineString MultiLineString Polygon MultiPolygon

coordinates

required

GeoJSON coordinates in CRS84 longitude and latitude (RFC 7946).

array

bbox

Bounding box as [west, south, east, north] in CRS84 longitude and latitude, or six numbers with heights.

Array<number>

>= 4 items <= 6 items

properties

required

Item properties. Any property listed by queryables can appear; the common ones are named here.

object

datetime

required

Acquisition time, UTC.

string | null format: date-time

platform

Normalized lowercase platform, for example sentinel-2c or landsat-9.

string

constellation

Constellation.

string

instruments

Instruments.

Array<string>

eo:cloud_cover

Scene cloud cover percentage from the producer.

number

<= 100

s2:mgrs_tile

Sentinel-2 MGRS tile.

string

s2:processing_baseline

Sentinel-2 processing baseline, which decides the DN offset.

string

landsat:wrs_path

Landsat WRS-2 path.

string

landsat:wrs_row

Landsat WRS-2 row.

string

sdn:source_collection

Native collection of an item returned through optical-sr.

string

Allowed values: sentinel-2-l2a dem landsat-ot-l2 landsat-etm-l2 landsat-tm-l2 hls optical-sr sentinel-1-rtc sentinel-2-l1c landsat-ot-l1 landsat-etm-l1 landsat-tm-l1 landsat-mss-l1

sdn:mask_source

Cloud-mask source for the item.

string

Allowed values: scl qa_pixel fmask s2cloudless none

sdn:mask_capabilities

Mask classes the item can detect.

Array<string>

sdn:harmonization

Harmonization level that applies to this item at the collection default.

string

Allowed values: none offset_removed bandpass_adjusted nbar

key

additional properties

any

assets

required

Assets keyed by native band name or role.

object

key

additional properties

STAC asset. href points at the public upstream COG.

object

href

required

Asset URL.

string format: uri

type

Media type.

string

title

Title.

string

roles

Asset roles such as data, overview or cloud.

Array<string>

sdn:band

Band name the asset holds, when it holds one band.

string

key

additional properties

any

links

required

Links, including self, collection and preview.

Array<object>

A STAC and OGC API link object.

object

href

required

Link target.

string format: uri

rel

required

Relation type, such as self, root, parent, next, prev, items, queryables, tiles or license.

string

type

Media type of the target.

string

title

Human-readable title.

string

method

HTTP method for the link, GET unless stated. Paging POST /v1/search uses POST.

string

Allowed values: GET POST

body

Request body to send with a POST link, used for the next page of POST /v1/search.

object

key

additional properties

any

merge

When true the client merges body into the previous request body.

boolean

Example

{
  "type": "Feature",
  "geometry": {
    "type": "Point"
  },
  "properties": {
    "sdn:source_collection": "sentinel-2-l2a",
    "sdn:mask_source": "scl",
    "sdn:harmonization": "none"
  },
  "links": [
    {
      "method": "GET"
    }
  ]
}

Headers

X-Request-Id

string

Request id for support and logs.

Example

01JQ7Z3M8R5V2W6X9Y0A1B2C3D

Cache-Control

string

Caching policy for CloudFront and browsers.

Example

public, max-age=3600, s-maxage=2592000, stale-if-error=604800

404

No resource has this id.

application/problem+json

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

type

required

URL of the documentation page for this problem type, stable for the life of /v1.

string format: uri

title

required

Short summary of the problem type. It does not change between occurrences.

string

status

required

HTTP status code, repeated for clients that lose the status line.

integer

>= 400 <= 599

detail

required

Explanation specific to this occurrence, written for a developer.

string

instance

Path of the request that failed.

string

code

Machine-readable problem code; equals the last path segment of type.

string

/^[a-z0-9-]+$/

requestId

Request id, also sent in X-Request-Id. Quote it in support requests.

string

errors

Field-level validation failures, present on 400 and 422.

Array<object>

One field-level failure.

object

pointer

required

JSON Pointer (RFC 6901) into the request body, or the query parameter name.

string

detail

required

What is wrong with that member.

string

retryAfter

Seconds until the request can succeed; equals the Retry-After header.

integer

limits

The limit that was hit and the value requested, for example maxWidth and requestedWidth.

object

key

additional properties

number

key

additional properties

any

Example

{
  "type": "https://docs.satellitedata.net/problems/not-found",
  "title": "Not found",
  "status": 404,
  "detail": "No item S2C_T15TVK_20260714T170911_L2X in collection sentinel-2-l2a.",
  "instance": "/v1/collections/sentinel-2-l2a/items/S2C_T15TVK_20260714T170911_L2X",
  "code": "not-found",
  "requestId": "01JQ7Z3M8R5V2W6X9Y0A1B2C3D"
}

Headers

X-Request-Id

string

Request id for support and logs.

Example

01JQ7Z3M8R5V2W6X9Y0A1B2C3D

429

The key’s rate limit or monthly quota (usage plan satdata-personal) was hit.

application/problem+json

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

type

required

URL of the documentation page for this problem type, stable for the life of /v1.

string format: uri

title

required

Short summary of the problem type. It does not change between occurrences.

string

status

required

HTTP status code, repeated for clients that lose the status line.

integer

>= 400 <= 599

detail

required

Explanation specific to this occurrence, written for a developer.

string

instance

Path of the request that failed.

string

code

Machine-readable problem code; equals the last path segment of type.

string

/^[a-z0-9-]+$/

requestId

Request id, also sent in X-Request-Id. Quote it in support requests.

string

errors

Field-level validation failures, present on 400 and 422.

Array<object>

One field-level failure.

object

pointer

required

JSON Pointer (RFC 6901) into the request body, or the query parameter name.

string

detail

required

What is wrong with that member.

string

retryAfter

Seconds until the request can succeed; equals the Retry-After header.

integer

limits

The limit that was hit and the value requested, for example maxWidth and requestedWidth.

object

key

additional properties

number

key

additional properties

any

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

X-Request-Id

string

Request id for support and logs.

Example

01JQ7Z3M8R5V2W6X9Y0A1B2C3D

Retry-After

integer

Seconds to wait before retrying.

Example

500

An unexpected server error. No units are charged.

application/problem+json

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

type

required

URL of the documentation page for this problem type, stable for the life of /v1.

string format: uri

title

required

Short summary of the problem type. It does not change between occurrences.

string

status

required

HTTP status code, repeated for clients that lose the status line.

integer

>= 400 <= 599

detail

required

Explanation specific to this occurrence, written for a developer.

string

instance

Path of the request that failed.

string

code

Machine-readable problem code; equals the last path segment of type.

string

/^[a-z0-9-]+$/

requestId

Request id, also sent in X-Request-Id. Quote it in support requests.

string

errors

Field-level validation failures, present on 400 and 422.

Array<object>

One field-level failure.

object

pointer

required

JSON Pointer (RFC 6901) into the request body, or the query parameter name.

string

detail

required

What is wrong with that member.

string

retryAfter

Seconds until the request can succeed; equals the Retry-After header.

integer

limits

The limit that was hit and the value requested, for example maxWidth and requestedWidth.

object

key

additional properties

number

key

additional properties

any

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

X-Request-Id

string

Request id for support and logs.

Example

01JQ7Z3M8R5V2W6X9Y0A1B2C3D