Get Collections

GET

/stac/collections

const url = 'https://example.com/stac/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://example.com/stac/collections

List all STAC Collections.

Responses

200

Successful Response

application/json

StacCollectionListResponse

STAC collections list response.

object

collections

required

Collections

List of STAC collections.

Array<object>

StacCollection

A single STAC Collection response (permissive — allows extra STAC fields).

object

description

Description

Collection description.

string

extent

required

Extent

Spatial and temporal extent of items in the collection.

object

key

additional properties

any

required

Stable collection identifier.

string

license

License

SPDX license identifier or ‘proprietary’.

string

default: proprietary

links

required

Links

Collection navigation links.

Array<object>

StacLink

A single STAC link object.

object

href

required

Href

Target URL of the link.

string

method

Any of:

string
null

string

rel

required

Rel

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

string

type

Any of:

string
null

string

stac_version

Stac Version

STAC specification version.

string

default: 1.0.0

title

Any of:

string
null

string

type

Type

STAC object type.

string

default: Collection

key

additional properties

any

links

required

Links

Top-level collection navigation links.

Array<object>

StacLink

A single STAC link object.

object

href

required

Href

Target URL of the link.

string

method

Any of:

string
null

string

rel

required

Rel

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

string

type

Any of:

string
null

string

Example

{
  "collections": [
    {
      "description": "",
      "license": "proprietary",
      "stac_version": "1.0.0",
      "type": "Collection"
    }
  ]
}

400

Bad request — invalid standards parameters

application/problem+json

ProblemDetail

object

detail

required

Any of:

string

status

required

Status

integer

title

required

Title

string

type

Type

string

default: about:blank

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

detail

required

Any of:

string

status

required

Status

integer

title

required

Title

string

type

Type

string

default: about:blank

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

detail

required

Any of:

string

status

required

Status

integer

title

required

Title

string

type

Type

string

default: about:blank

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

detail

required

Any of:

string

status

required

Status

integer

title

required

Title

string

type

Type

string

default: about:blank

Example

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