Single feature

Fetch one feature from a collection by its featureId. The response is a single GeoJSON Feature, the same object you would find inside the features array of a FeatureCollection, returned on its own with Content-Type: application/geo+json.

Requires an organization API key with the GIS_ACCESS addon in the X-API-Key header, plus a license for the dataset. A single-feature request costs 1 credit; see Rate limits and credits. See Authentication.

Get a feature

The featureId is the value of a feature's id field, as returned by the items endpoint.

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/ogc/collections/transport_infrastructure_bushaltes/items/transport_infrastructure_bushaltes.1"

{
  "type": "Feature",
  "id": "transport_infrastructure_bushaltes.1",
  "geometry": {
    "type": "Point",
    "coordinates": [4.8952, 52.3702]
  },
  "properties": {
    "name": "Amsterdam, Centraal Station",
    "category": "bus_stop",
    "city": "Amsterdam",
    "country": "nl",
    "postal_code": "1012 AB",
    "street": "Stationsplein"
  },
  "links": [
    {
      "rel": "self",
      "type": "application/geo+json",
      "href": "https://api.topolab.nl/v1/ogc/collections/transport_infrastructure_bushaltes/items/transport_infrastructure_bushaltes.1"
    },
    {
      "rel": "collection",
      "type": "application/json",
      "href": "https://api.topolab.nl/v1/ogc/collections/transport_infrastructure_bushaltes"
    }
  ]
}

Reading the feature

• id, the stable identifier for this feature within the collection. Use it in the URL to refetch the feature.
• geometry, a GeoJSON geometry. Points are [longitude, latitude] in WGS84 (EPSG:4326).
• properties, the dataset attributes for this feature. The available keys depend on the dataset's schema.
• links, a self link back to the feature and a collection link to its parent collection.

Errors

Status	Meaning
401	Missing or invalid API key (API key is required).
403	Key is valid but the organization lacks the GIS_ACCESS addon.
404	Unknown collectionId or featureId, or a dataset your organization is not licensed for.
429	Rate limit exceeded.

An unknown collection, an unknown feature, and a collection your organization is not licensed for all return the same 404. There is no separate "not licensed" status, so the API does not reveal which datasets exist beyond the ones you can already list.

Next

• Items, list features and discover their ids.
• bbox and filtering, find features by area or attribute.