v39

latestOpenAPI 3.0.3raw.githubusercontent.com2026-06-18118982.1 KB

Data

Fetch a single collection

Describe the feature collection with id collectionId

get/collections/{collectionId}

Path parameters

collectionIdstring required

Local identifier of a collection

Headers

If-Matchstring

The RFC7232 If-Match header field makes the GET request method conditional. It is composed of a comma separated list of ETags or value "*".

The server compares the client's ETags (sent with If-Match) with the ETag for its current version of the resource, and if both values don't match (that is, the resource has changed), the server sends back a 412 Precondition Failed status, without a body, which tells the client that the cached version of the response is not good to use anymore.

If-None-Matchstring

The RFC7232 If-None-Match header field makes the GET request method conditional. It is composed of a comma separated list of ETags or value "*".

The server compares the client's ETags (sent with If-None-Match) with the ETag for its current version of the resource, and if both values match (that is, the resource has not changed), the server sends back a 304 Not Modified status, without a body, which tells the client that the cached version of the response is still good to use (fresh).

Response

Information about the feature collection with id collectionId.

The response contains a link to the items in the collection (path /collections/{collectionId}/items, link relation items) as well as key information about the collection. This information includes:

A local identifier for the collection that is unique for the dataset
A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude)
An optional title and description for the collection
An optional extent that can be used to provide an indication of the spatial and temporal extent of the collection - typically derived from the data
An optional indicator about the type of the items in the collection (the default value, if the indicator is not provided, is 'feature')

crsstring[]

The list of coordinate reference systems supported by the service

descriptionstring required

A description of the features in the collection

idstring required

Identifier of the collection used, for example, in URIs

itemTypestring

Indicator about the type of the items in the collection (the default value is 'Feature').

typestring required

Value: "Collection"

licensestring required

License(s) of the data as a SPDX License identifier. Alternatively, use proprietary if the license is not on the SPDX license list or various if multiple licenses apply. In these two cases links to the license texts SHOULD be added, see the license link relation type.

Non-SPDX licenses SHOULD add a link to the license text with the license relation in the links section. The license text MUST NOT be provided as a value of this field. If there is no public license URL available, it is RECOMMENDED to host the license text and link to it.

stac_versionstring required

summariesobject

Summaries are either a unique set of all available values or statistics. Statistics by default only specify the range (minimum and maximum values), but can optionally be accompanied by additional statistical values. The range can specify the potential range of values, but it is recommended to be as precise as possible. The set of values must contain at least one element and it is strongly recommended to list all values. It is recommended to list as many properties as reasonable so that consumers get a full overview of the Collection. Properties that are covered by the Collection specification (e.g. providers and license) may not be repeated in the summaries.

titlestring

Human readable title of the collection

createdstring date-time required

RFC 3339 compliant datetime string, time when the object was created

updatedstring date-time required

RFC 3339 compliant datetime string, time when the object was updated

assetsItemAssets

List of Assets attached to this feature.

Example response

{
  "crs": [
    "http://www.opengis.net/def/crs/OGC/1.3/CRS84"
  ],
  "description": "Swiss Map Raster are a conversion of the map image into a digital form with no direct bearing on the individual map elements.\n\nThe information is structured only in colour layers. Swiss Map Raster pixel maps are ideal for finding background information for a broad variety of screen applications, web and mobile applications and services, as well as for geographic information systems. They can also be used as basic maps for a variety of purposes (digital printing, plots, offset printing, etc.).",
  "extent": {
    "spatial": {
      "bbox": [
        [
          5.685114,
          45.534903,
          10.747775,
          47.982586
        ]
      ]
    },
    "temporal": {
      "interval": [
        [
          "2019-01-01T00:00:00Z",
          "2019-01-02T00:00:00Z"
        ]
      ]
    }
  },
  "id": "ch.swisstopo.pixelkarte-farbe-pk200.noscale",
  "type": "Collection",
  "license": "proprietary",
  "providers": [
    {
      "name": "Federal Office of Topography - swisstopo",
      "roles": [
        "producer",
        "licensor"
      ],
      "url": "https://www.swisstopo.admin.ch"
    }
  ],
  "stac_version": "1.0.0",
  "summaries": {
    "gsd": [
      10,
      20
    ],
    "geoadmin:variant": [
      "kgrel",
      "komb",
      "krel"
    ],
    "geoadmin:lang": [
      "de",
      "fr"
    ],
    "proj:epsg": [
      2056
    ]
  },
  "title": "National Map 1:200'000",
  "created": "2018-02-12T23:20:50Z",
  "updated": "2018-02-12T23:20:50Z",
  "assets": {
    "smr50-263-2016-2056-kgrs-2.5.tiff": {
      "file:checksum": "12200ADEC47F803A8CF1055ED36750B3BA573C79A3AF7DA6D6F5A2AED03EA16AF3BC",
      "created": "2020-07-14T12:30:00Z",
      "gsd": 2.5,
      "geoadmin:variant": "kgrs",
      "href": "https://data.geo.admin.ch/ch.swisstopo.pixelkarte-farbe-pk50.noscale/smr50-263-2016-2056-kgrs-2.5.tiff",
      "proj:epsg": 2056,
      "type": "image/tiff; application=geotiff",
      "updated": "2020-07-14T12:30:00Z"
    },
    "smr50-263-2016-2056-komb-2.5.tiff": {
      "file:checksum": "12200ADEC47F803A8CF1055ED36750B3BA573C79A3AF7DA6D6F5A2AED03EA16AF3BC",
      "created": "2020-07-14T12:30:00Z",
      "gsd": 2.5,
      "geoadmin:variant": "komb",
      "href": "https://data.geo.admin.ch/ch.swisstopo.pixelkarte-farbe-pk50.noscale/smr50-263-2016-2056-komb-2.5.tiff",
      "proj:epsg": "2056",
      "type": "image/tiff; application=geotiff",
      "updated": "2020-07-14T12:30:00Z"
    },
    "smr50-263-2016-2056-krel-2.5.tiff": {
      "file:checksum": "12200ADEC47F803A8CF1055ED36750B3BA573C79A3AF7DA6D6F5A2AED03EA16AF3BC",
      "created": "2020-07-14T12:30:00Z",
      "gsd": 2.5,
      "geoadmin:variant": "krel",
      "href": "https://data.geo.admin.ch/ch.swisstopo.pixelkarte-farbe-pk50.noscale/smr50-263-2016-2056-krel-2.5.tiff",
      "proj:epsg": "2056",
      "type": "image/tiff; application=geotiff",
      "updated": "2020-07-14T12:30:00Z"
    }
  },
  "links": [
    {
      "href": "https://data.geo.admin.ch/api/stac/v1/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale",
      "rel": "self"
    },
    {
      "href": "https://data.geo.admin.ch/api/stac/v1/",
      "rel": "root"
    },
    {
      "href": "https://data.geo.admin.ch/api/stac/v1",
      "rel": "parent"
    },
    {
      "href": "https://data.geo.admin.ch/api/stac/v1/collections/ch.swisstopo.pixelkarte-farbe-pk50.noscale/items",
      "rel": "items"
    },
    {
      "href": "https://www.swisstopo.admin.ch/en/home/meta/conditions/geodata/free-geodata.html",
      "rel": "license",
      "title": "Licence for the free geodata of the Federal Office of Topography swisstopo"
    },
    {
      "href": "https://www.geocat.ch/geonetwork/srv/eng/catalog.search#/metadata/4c8c7c58-61c7-4a61-8e7a-6ffb95d183df",
      "rel": "describedby"
    }
  ]
}