--- title: "Fetch a single collection" method: GET path: "/collections/{collectionId}" tags: ["Data"] --- # Fetch a single collection `GET /collections/{collectionId}` Describe the feature collection with id `collectionId` ## Path parameters - `collectionId` string, required ## Headers - `If-Match` string - `If-None-Match` string ## Response `200` 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') - Collection - `crs` string[] — The list of coordinate reference systems supported by the service - `description` string, required — A description of the features in the collection - `extent` Extent, required — The extent of the features in the collection. In the Core only spatial and temporal extents are specified. Extensions may add additional members to represent other extents, for example, thermal or pressure ranges. - `spatial` object, required — The spatial extent of the features in the collection. - `bbox` array[], required — One or more bounding boxes that describe the spatial extent of the dataset. In the Core only a single bounding box is supported. Extensions may support additional areas. If multiple areas are provided, the union of the bounding boxes describes the spatial extent. - number[] — Each bounding box is provided as four or six numbers, depending on whether the coordinate reference system includes a vertical axis (height or depth): * Lower left corner, coordinate axis 1 * Lower left corner, coordinate axis 2 * Upper right corner, coordinate axis 1 * Upper right corner, coordinate axis 2 The coordinate reference system of the values is WGS 84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84). For WGS 84 longitude/latitude the values are in most cases the sequence of minimum longitude, minimum latitude, maximum longitude and maximum latitude. However, in cases where the box spans the antimeridian the first value (west-most box edge) is larger than the third value (east-most box edge). If the vertical axis is included, the third and the sixth number are the bottom and the top of the 3-dimensional bounding box. If a feature has multiple spatial geometry properties, it is the decision of the server whether only a single spatial geometry property is used to determine the extent or all relevant geometries. - `temporal` object, required — The temporal extent of the features in the collection. - `interval` array[], required — One time interval that describe the temporal extent of the dataset. - string[] — Begin and end times of the time interval. - `id` string, required — Identifier of the collection used, for example, in URIs - `itemType` string — Indicator about the type of the items in the collection (the default value is 'Feature'). - `type` string, required — Value: `"Collection"` - `license` string, required — License(s) of the data as a SPDX [License identifier](https://spdx.org/licenses/). 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. - `providers` object[] — A list of providers, which may include all organizations capturing or processing the data or the hosting provider. Providers should be listed in chronological order with the most recent provider being the last element of the list. - `description` string — Multi-line description to add further provider information such as processing details for processors and producers, hosting details for hosts or basic contact information. CommonMark 0.29 syntax MAY be used for rich text representation. - `name` string, required — The name of the organization or the individual. - `roles` string[] — Roles of the provider. The provider's role(s) can be one or more of the following elements: * licensor: The organization that is licensing the dataset under the license specified in the collection's license field. * producer: The producer of the data is the provider that initially captured and processed the source data, e.g. ESA for Sentinel-2 data. * processor: A processor is any provider who processed data to a derived product. * host: The host is the actual provider offering the data on their storage. There should be no more than one host, specified as last element of the list. - `url` string, url — Homepage on which the provider describes the dataset and publishes contact information. - `stac_version` string, required - `summaries` object — 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. - `title` string — Human readable title of the collection - `created` string, date-time, required — RFC 3339 compliant datetime string, time when the object was created - `updated` string, date-time, required — RFC 3339 compliant datetime string, time when the object was updated - `assets` ItemAssets — List of Assets attached to this feature. - `links` Link[], required - `href` string, url, required - `rel` string, required — Relationship between the current document and the linked document. NOTE: the following relations are reserved and automatically generated: `self`, `root`, `parent`, `items`, `collection`, `next`, `previous` - `title` string - `type` string — The media type of the link target - `method` 'GET' | 'POST' — Specifies the HTTP method that the link expects - `hreflang` string — The language of the link target ## Other responses - `304` — The cached resource was not modified since last request. - `404` — The specified resource/URI was not found - `412` — Some condition specified by the request could not be met in the server - `500` — The request was syntactically and semantically valid, but an error occurred while trying to act upon it --- [API](https://skmtc.net/geoadmin/apis/the-spatiotemporal-asset-catalog-api-for-data-geo-admin-ch.md) · [All operations](https://skmtc.net/geoadmin/apis/the-spatiotemporal-asset-catalog-api-for-data-geo-admin-ch/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geoadmin/the-spatiotemporal-asset-catalog-api-for-data-geo-admin-ch/versions/015864bb4d77/schema)