List Collections

GET

/collections

const url = 'https://example.com/collections?offset=0&limit=50';
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/collections?offset=0&limit=50'

List available OGC collections (catalog + per-dataset feature collections).

Authorizations

Parameters

Query Parameters

offset

Offset

Pagination offset for per-dataset collections

integer

Pagination offset for per-dataset collections

limit

Limit

Max per-dataset collections to return

integer

default: 50 >= 1 <= 200

Max per-dataset collections to return

Responses

200

Successful Response

application/json

OGCCollectionsResponse

Response for /collections listing all available OGC collections.

object

collections

required

Collections

Array<object>

object

key

additional properties

any

links

Links

Array<object>

default:

OGCRecordLink

Link object in OGC API Records.

object

href

required

Href

string

rel

required

Rel

string

type

required

Type

string

Example

{
  "links": []
}

400

Bad request — invalid query parameters or payload

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