Skip to content
getgeolens.com
GeoLens Docs

Get Collection Items

GET
/collections/{dataset_id}/items
 
curl --request GET \
  --url 'https://example.com/collections/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/items?limit=10&offset=0&include_geometry=true' \
  --header 'Authorization: Bearer <token>'

OGC API Features items endpoint — returns GeoJSON FeatureCollection for a dataset.

Note: datetime is accepted per OGC API Features Core but acts as a no-op for per-dataset feature queries. Per-dataset feature tables contain user-uploaded data with no standard temporal column, so the spec provision “if the collection does not include temporal information, the datetime parameter SHALL be ignored” applies (OGC 17-069r4 §7.15.5).

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
dataset_id
required
Dataset Id
string format: uuid

Query Parameters

Section titled “Query Parameters ”
limit
Limit
integer
default: 10 >= 1 <= 200
offset
Offset

Legacy offset-based pagination. Prefer after_gid keyset cursor (via the next link) — offset is retained for backward compatibility but is O(N) at high values.

integer
0

Legacy offset-based pagination. Prefer after_gid keyset cursor (via the next link) — offset is retained for backward compatibility but is O(N) at high values.

after_gid
Any of:
integer

Keyset cursor: returns features with gid > after_gid. Phase 269 H-24 primary pagination path; use the rel=next link for follow-up pages.

bbox
Any of:
string

Bounding box: minx,miny,maxx,maxy

datetime
Any of:
string

OGC datetime interval: instant, start/end, ../end, start/..

f
Any of:
string
include_geometry
Include Geometry

Include geometry in response. Set to false for attribute-only queries.

boolean
default: true

Include geometry in response. Set to false for attribute-only queries.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

OGCFeatureItemsResponse

OGC API Features compliant feature collection response.

object
features
required
Features

GeoJSON features returned by the query.

Array<object>
object
key
additional properties
any
links
required
Links

Pagination and self-reference links.

Array<object>
OGCLink
object
href
required
Href

Target URL of the link.

string
rel
required
Rel

Link relation type per RFC 8288 (e.g. ‘self’, ‘next’, ‘prev’, ‘data’, ‘collection’).

string
title
Any of:
string
type
required
Type

Media type of the linked resource (e.g. ‘application/json’, ‘application/geo+json’).

string
numberMatched
required
Numbermatched

Total number of features matching the query (across all pages).

integer
numberReturned
required
Numberreturned

Number of features in this response page.

integer
timeStamp
Timestamp

ISO 8601 timestamp the response was generated.

string
type
Type

GeoJSON object type.

string
default: FeatureCollection
Allowed value: FeatureCollection
Example 
{
  "type": "FeatureCollection"
}

400

Section titled “400 ”

Bad request — invalid query parameters or payload

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

404

Section titled “404 ”

Not found

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

422

Section titled “422 ”

Validation error

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

500

Section titled “500 ”

Internal server error

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}