Get Collection Item

GET

/collections/datasets/items/{record_id}

curl --request GET \
  --url https://example.com/collections/datasets/items/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0

Get a single dataset as an OGC Record Feature.

Authorizations

• None
• OAuth2PasswordBearer
• ApiKeyHeader
• ApiKeyQuery

Parameters

Path Parameters

record_id

required

Record Id

string format: uuid

Responses

200

Successful Response

OGCRecordResponse

Single OGC API Records Feature.

object

type

Type

string

default: Feature

id

required

Id

string

conformsTo

Any of:

Array<string>

Array<string>

null

null

time

required

Time

object

key

additional properties

any

geometry

Any of:

object

object

key

additional properties

any

null

null

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

string format: date-time

null

null

updated

Any of:

string

string format: date-time

null

null

updated_by_display

Any of:

string

string

null

null

never_edited

Never Edited

boolean

crs

Any of:

string

string

null

null

record_type

Record Type

string

default: vector_dataset

band_count

Any of:

integer

integer

null

null

geometry_type

Any of:

string

string

null

null

feature_count

Any of:

integer

integer

null

null

row_count

Any of:

integer

integer

null

null

column_count

Any of:

integer

integer

null

null

license

required

License

string

source_organization

Any of:

string

string

null

null

source_format

Any of:

string

string

null

null

quality_detail

Any of:

object

object

key

additional properties

any

null

null

quality_statement

Any of:

string

string

null

null

formats

Any of:

Array<string>

Array<string>

null

null

language

Any of:

string

string

null

null

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

string

null

null

contacts

required

Contacts

Array<object>

object

key

additional properties

any

time

required

Time

object

key

additional properties

any

lineage

Any of:

string

string

null

null

update_frequency

Any of:

string

string

null

null

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

string format: date-time

null

null

last_refreshed_at

Any of:

string

string format: date-time

null

null

constraints

Any of:

object

object

key

additional properties

any

null

null

distributions

Any of:

Array<object>

Array<object>

object

key

additional properties

any

null

null

record_status

Any of:

string

string

null

null

has_quicklook

Has Quicklook

boolean

gsd

Any of:

number

number

null

null

res_x

Any of:

number

number

null

null

res_y

Any of:

number

number

null

null

crs_is_geographic

Any of:

boolean

boolean

null

null

vrt_type

Any of:

string

string

null

null

source_count

Any of:

integer

integer

null

null

dataset_count

Any of:

integer

integer

null

null

proj:code

Any of:

string

string

null

null

proj:shape

Any of:

array

array

>= 2 items <= 2 items

null

null

raster:bands

Any of:

Array<object>

Array<object>

OGCRasterBand

One entry in the raster:bands STAC extension array.

This matches the per-band data returned by catalog search. statistics uses the normalized raster band metadata shape.

object

name

Any of:

string

string

null

null

data_type

Any of:

string

string

null

null

nodata

Any of:

string

string

integer

integer

number

number

null

null

statistics

Any of:

object

object

key

additional properties

any

null

null

description

Any of:

string

string

null

null

null

null

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

object

key

additional properties

OGCAsset

STAC-style asset entry for an OGC Record.

object

href

required

Href

string

type

Any of:

string

string

null

null

title

Any of:

string

string

null

null

roles

Any of:

Array<string>

Array<string>

null

null

null

null

bbox

Any of:

Array<number>

Array<number>

null

null

Example

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

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

string

object

object

key

additional properties

any

Array

Array

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.

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

string

object

object

key

additional properties

any

Array

Array

Example

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

404

Not found

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

string

object

object

key

additional properties

any

Array

Array

Example

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

429

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

string

object

object

key

additional properties

any

Array

Array

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

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

string

object

object

key

additional properties

any

Array

Array

Example

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

503

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

string

object

object

key

additional properties

any

Array

Array

Example

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