Get Item

GET

/stac/items/{item_id}

const url = 'https://example.com/stac/items/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
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://example.com/stac/items/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0

Get a single STAC Item by dataset ID.

Authorizations

Parameters

Path Parameters

item_id

required

Item Id

string format: uuid

Responses

200

Successful Response

application/geo+json

StacItemResponse

A GeoJSON Feature conforming to the STAC Item specification.

object

type

Type

string

default: Feature

Allowed value: Feature

stac_version

required

Stac Version

STAC specification version.

string

stac_extensions

Stac Extensions

STAC extension schema URIs in use.

Array<string>

required

Stable item identifier.

string

geometry

required

Any of:

GeoJSONGeometryCollection

A GeoJSON GeometryCollection (RFC 7946 §3.1.8).

Geometry collections carry geometries instead of coordinates. Only generic-geometry datasets accept them on write.

Nested collections are rejected because PostGIS cannot round-trip them through the GeoJSON boundary.

object

type

required

Type

string

Allowed value: GeometryCollection

geometries

required

Geometries

Array<object>

GeoJSONGeometry

A GeoJSON geometry object (RFC 7946).

object

type

required

Type

string

Allowed values: Point MultiPoint LineString MultiLineString Polygon MultiPolygon

coordinates

required

Coordinates

Array

bbox

Any of:

array

>= 4 items <= 4 items

properties

required

StacItemProperties

Core STAC Item properties plus extension-defined fields.

object

datetime

required

Any of:

string
null

string

start_datetime

Any of:

string
null

string

end_datetime

Any of:

string
null

string

title

Any of:

string
null

string

description

Any of:

string
null

string

key

additional properties

any

links

required

Links

Array<object>

StacLink

A single STAC link object.

object

href

required

Href

Target URL of the link.

string

rel

required

Rel

Link relation type (e.g. ‘self’, ‘root’, ‘parent’, ‘item’, ‘data’).

string

type

Any of:

string
null

string

method

Any of:

string
null

string

assets

required

Assets

object

key

additional properties

StacItemAsset

A STAC asset attached to an Item.

object

href

required

Href

URL of the asset resource.

string

type

Any of:

string
null

string

title

Any of:

string
null

string

description

Any of:

string
null

string

roles

Any of:

Array<string>
null

Array<string>

key

additional properties

any

collection

Any of:

string
null

string

key

additional properties

any

Example

{
  "assets": {},
  "collection": "geolens-unassigned",
  "id": "0190f4c8-8c6a-7a21-9a34-13bc2f31dc02",
  "links": [],
  "properties": {
    "datetime": "2026-01-15T00:00:00Z"
  },
  "stac_version": "1.0.0",
  "type": "Feature"
}

400

Bad request — invalid standards parameters

application/problem+json

ProblemDetail

object

type

Type

string

default: about:blank

title

required

Title

string

status

required

Status

integer

detail

required

Any of:

string

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

401

Unauthenticated — a credential was supplied and could not be resolved (expired, revoked, or malformed). Sending no credential at all is not an error on these operations; they answer anonymously with the public subset.

application/problem+json

ProblemDetail

object

type

Type

string

default: about:blank

title

required

Title

string

status

required

Status

integer

detail

required

Any of:

string

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

404

Not found

application/problem+json

ProblemDetail

object

type

Type

string

default: about:blank

title

required

Title

string

status

required

Status

integer

detail

required

Any of:

string

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

429

Too many requests — retry after the advertised interval

application/problem+json

ProblemDetail

object

type

Type

string

default: about:blank

title

required

Title

string

status

required

Status

integer

detail

required

Any of:

string

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

Headers

Retry-After

integer

Seconds until the request may be retried

500

Internal server error

application/problem+json

ProblemDetail

object

type

Type

string

default: about:blank

title

required

Title

string

status

required

Status

integer

detail

required

Any of:

string

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

503

Service unavailable — the database could not serve the request

application/problem+json

ProblemDetail

object

type

Type

string

default: about:blank

title

required

Title

string

status

required

Status

integer

detail

required

Any of:

string

Example

{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

Privacy Apache 2.0 getgeolens.com