Skip to content
getgeolens.com

Get Collections

GET
/stac/collections
curl --request GET \
--url https://example.com/stac/collections

List all STAC Collections.

Successful Response

Media type 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
type
Type

STAC object type.

string
default: Collection
stac_version
Stac Version

STAC specification version.

string
default: 1.0.0
id
required
Id

Stable collection identifier.

string
title
Any of:
string
description
Description

Collection description.

string
""
license
License

SPDX license identifier or ‘proprietary’.

string
default: proprietary
extent
required
Extent

Spatial and temporal extent of items in the collection.

object
key
additional properties
any
links
required
Links

Collection navigation 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
method
Any of:
string
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
rel
required
Rel

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

string
type
Any of:
string
method
Any of:
string
Example
{
"collections": [
{
"type": "Collection",
"stac_version": "1.0.0",
"description": "",
"license": "proprietary"
}
]
}

Bad request — invalid standards parameters

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

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. Neither is sending an unresolvable credential alongside a capability that authorizes the request on its own — a valid X-Embed-Token or a valid signed tile template (sig, exp, scope). Those are served and the unrelated credential is ignored.

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

Too many requests — retry after the advertised interval

Media type 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"
}
Retry-After
integer

Seconds until the request may be retried

Internal server error

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

Service unavailable — the database could not serve the request

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