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'

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

Page size for bulk GeoJSON export. The maximum is an admin-configurable ceiling (default 1000; Network settings tab, ogc_items_max_page_size) rather than the 200 used by offset-paged list endpoints, because this route pages via the constant-time after_gid keyset cursor. Per OGC API Features Core /req/core/fc-limit-response-1(C) a value above the ceiling is clamped to it, not rejected.

integer
default: 10 >= 1

Page size for bulk GeoJSON export. The maximum is an admin-configurable ceiling (default 1000; Network settings tab, ogc_items_max_page_size) rather than the 200 used by offset-paged list endpoints, because this route pages via the constant-time after_gid keyset cursor. Per OGC API Features Core /req/core/fc-limit-response-1(C) a value above the ceiling is clamped to it, not rejected.

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

FeatureCollection response as defined by OGC API - Features.

object
type
Type

GeoJSON object type.

string
default: FeatureCollection
Allowed value: FeatureCollection
timeStamp
Timestamp

ISO 8601 timestamp the response was generated.

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

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

string
title
Any of:
string
Example 
{
  "type": "FeatureCollection"
}

400

Section titled “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
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

401

Section titled “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.

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

404

Section titled “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
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

429

Section titled “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
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until the request may be retried

500

Section titled “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
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

503

Section titled “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
Example 
{
  "detail": "Dataset not found",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}
Privacy Apache 2.0 getgeolens.com