API reference

Endpoints, query parameters, CQL2 filters, coordinate systems and API keys for Waystones Cloud OGC API – Features services.

Every Waystones Cloud project with OGC API – Features is served at https://<slug>.waystones.cloud (or your custom domain) by oapif-go, an open-source OGC API server.

Endpoints

Request	Returns
`/`	Landing page
`/conformance`	Supported OGC conformance classes
`/collections`	All collections
`/collections/{id}`	One collection, with its extent
`/collections/{id}/items`	Features (GeoJSON)
`/collections/{id}/items/{featureId}`	One feature
`/collections/{id}/queryables`	Fields you can filter on
`/api`	OpenAPI document (`/api.html` to browse it)

Query parameters

On /collections/{id}/items:

Parameter	Example	Notes
`limit`	`limit=100`	Default 10, maximum 1000. Follow the `next` link to page.
`bbox`	`bbox=10.6,59.8,10.9,60.0`	In CRS84 unless you set `bbox-crs`.
`crs`	`crs=http://www.opengis.net/def/crs/EPSG/0/25833`	Output coordinates in another supported CRS.
`properties`	`properties=name,height`	Return only these fields.
`sortby`	`sortby=-height`	`-` sorts descending.
`filter`	`filter=height > 20`	CQL2 text; add `filter-lang=cql2-json` for JSON.
`datetime`	`datetime=2024-01-01/..`	For collections with a time field.
`f`	`f=json`, `f=html`	Output format.

Private services

Private projects (Wayfarer plan and up) need an API key. Create keys on the project page, then send them in a header:

curl -H "Authorization: ApiKey <your-key>" https://my-data.waystones.cloud/collections

Clients that can't set headers can add ?api_key=<your-key> to the URL instead.

Coordinate systems

Features are returned in CRS84 (WGS 84 longitude/latitude) unless you ask for another CRS with crs. Each collection lists the systems it supports under crs in /collections/{id}: CRS84, EPSG:4326, the data's native CRS and a set of common ones.

Response formats

Add f=json for GeoJSON or f=html for a browsable page. Browsers get HTML by default; other clients get JSON.

Limits

limit is capped at 1000 features per page; use the next link to page through larger results.
On the free plan, a service pauses for the rest of the month after 250,000 requests and returns HTTP 429 with a QUOTA_EXCEEDED code. See Pricing.