Collection Items

GET

/collections/datasets/items

const url = 'https://example.com/collections/datasets/items?sort_by=relevance&offset=0&limit=10&cql2_filter_lang=cql2-text&exclude_synthetic=true&spatial_predicate=intersects';
const options = {
  method: 'GET',
  headers: {'Content-Type': 'application/json'},
  body: '["example"]'
};

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/datasets/items?sort_by=relevance&offset=0&limit=10&cql2_filter_lang=cql2-text&exclude_synthetic=true&spatial_predicate=intersects' \
  --header 'Content-Type: application/json' \
  --data '[ "example" ]'

OGC API Records items endpoint — mirrors /search/datasets.

Authorizations

Parameters

Query Parameters

type

Type

Public OGC resource types as repeated or comma-separated values (for example, type=dataset,collection)

Array<string>

Public OGC resource types as repeated or comma-separated values (for example, type=dataset,collection)

ids

Ids

Record IDs as repeated or comma-separated UUID values

Array<string>

Record IDs as repeated or comma-separated UUID values

externalIds

Externalids

Source-system resource identifiers as repeated or comma-separated values

Array<string>

Source-system resource identifiers as repeated or comma-separated values

sortby

Any of:

string
null

string

OGC sortby: +field or -field

~~externalId~~

deprecated

Any of:

string
null

string

Deprecated singular compatibility alias for externalIds (matches a dataset UUID)

Any of:

string
null

string

<= 1000 characters

bbox

Any of:

string
null

string

geometry_type

Any of:

string
null

string

srid

Any of:

integer
null

integer

source_organization

Any of:

string
null

string

record_type

Any of:

string
null

string

date_from

Any of:

string
null

string format: date

date_to

Any of:

string
null

string format: date

vintage_start

Any of:

string
null

string format: date

vintage_end

Any of:

string
null

string format: date

sort_by

Sort By

string

default: relevance

sort_desc

Any of:

boolean
null

boolean

offset

Offset

integer

limit

Limit

integer

default: 10 >= 1

filter

Any of:

string
null

string

<= 10000 characters

cql2_filter_lang

Cql2 Filter Lang

string

default: cql2-text

datetime

Any of:

string
null

string

exclude_synthetic

Exclude Synthetic

boolean

default: true

spatial_predicate

Spatial Predicate

string

default: intersects

Allowed values: intersects within

geometry

Any of:

string
null

string

<= 50000 characters

collection_id

Any of:

string
null

string format: uuid

Request Body

application/json

Any of:

Array<string>
null

Array<string>

Example ^generated

[
  "example"
]

Responses

200

Successful Response

OGCFeatureCollectionResponse

OGC API Records FeatureCollection with match counts.

object

type

Type

string

default: FeatureCollection

timeStamp

Any of:

string
null

string

numberMatched

required

Numbermatched

Total records matching the query

integer

numberReturned

required

Numberreturned

Number of records in this response page

integer

features

required

Features

Array<object>

OGCRecordResponse

Single OGC API Records Feature.

object

type

Type

string

default: Feature

required

string

conformsTo

Any of:

Array<string>
null

Array<string>

time

required

Time

object

key

additional properties

any

geometry

Any of:

object
null

object

key

additional properties

any

properties

required

OGCRecordProperties

Properties block of an OGC API Records Feature.

object

type

Type

string

default: dataset

title

required

Title

string

description

required

Description

string

keywords

required

Keywords

Array<string>

created

Any of:

string
null

string format: date-time

updated

Any of:

string
null

string format: date-time

updated_by_display

Any of:

string
null

string

never_edited

Never Edited

boolean

crs

Any of:

string
null

string

record_type

Record Type

string

default: vector_dataset

band_count

Any of:

integer
null

integer

geometry_type

Any of:

string
null

string

feature_count

Any of:

integer
null

integer

row_count

Any of:

integer
null

integer

column_count

Any of:

integer
null

integer

license

required

License

string

source_organization

Any of:

string
null

string

source_format

Any of:

string
null

string

quality_detail

Any of:

object
null

object

key

additional properties

any

quality_statement

Any of:

string
null

string

formats

Any of:

Array<string>
null

Array<string>

language

Any of:

string
null

string

externalIds

Externalids

Identifiers assigned by the described resource’s source system.

Array<string>

themes

required

Themes

Array<object>

object

key

additional properties

any

rights

Any of:

string
null

string

contacts

required

Contacts

Array<object>

object

key

additional properties

any

time

required

Time

object

key

additional properties

any

lineage

Any of:

string
null

string

update_frequency

Any of:

string
null

string

source_freshness

Source Freshness

Fresh, due, overdue, or unknown — how the dataset’s last refresh compares to its declared update_frequency. ‘unknown’ for origins nothing can refresh. Advisory only, and distinct from the quality score’s own freshness.

string

default: unknown

source_health

Source Health

Healthy, missing, inaccessible, or unknown. ‘unknown’ means never probed, or an origin kind with nothing to probe.

string

default: unknown

last_checked_at

Any of:

string
null

string format: date-time

last_refreshed_at

Any of:

string
null

string format: date-time

constraints

Any of:

object
null

object

key

additional properties

any

distributions

Any of:

Array<object>
null

Array<object>

object

key

additional properties

any

record_status

Any of:

string
null

string

has_quicklook

Has Quicklook

boolean

gsd

Any of:

number
null

number

crs_is_geographic

Any of:

boolean
null

boolean

vrt_type

Any of:

string
null

string

source_count

Any of:

integer
null

integer

dataset_count

Any of:

integer
null

integer

links

required

Links

Array<object>

OGCRecordLink

Link object in OGC API Records.

object

rel

required

Rel

string

href

required

Href

string

type

required

Type

string

assets

Any of:

object
null

object

key

additional properties

OGCAsset

STAC-style asset entry for an OGC Record.

object

href

required

Href

string

type

required

Type

string

title

Any of:

string
null

string

roles

Any of:

Array<string>
null

Array<string>

bbox

Any of:

Array<number>
null

Array<number>

links

Any of:

Array<object>
null

Array<object>

OGCRecordLink

Link object in OGC API Records.

object

rel

required

Rel

string

href

required

Href

string

type

required

Type

string

Example

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "type": "dataset",
        "never_edited": false,
        "record_type": "vector_dataset",
        "source_freshness": "unknown",
        "source_health": "unknown",
        "has_quicklook": false
      }
    }
  ]
}

Example ^generated

example

400

Bad request — invalid query parameters or payload

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. 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.

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

Collection Items

Authorizations

Parameters

Query Parameters

Request Body

Example generated

Responses

200

Example

Example generated

400

Example

401

Example

404

Example

429

Example

Headers

500

Example

503

Example

Example ^generated

Example ^generated