Get Collection

GET

/stac/collections/{collection_id}

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

Get a single STAC Collection.

Parameters

Path Parameters

collection_id

required

Collection Id

string

Responses

200

Successful Response

application/json

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

Example

{
  "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"
}

404

Not found

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"
}