---
title: "Search STAC items with simple filtering."
method: GET
path: "/search"
tags: ["STAC"]
---

# Search STAC items with simple filtering.

`GET /search`

## Request

- Base URL: `https://data.geo.admin.ch/api/stac/v1`
- URL: `https://data.geo.admin.ch/api/stac/v1/search`
- Auth: none declared

Retrieve Items matching filters. Intended as a shorthand API for simple queries. To filter by fields in "properties" please use the [POST /search](#tag/STAC/operation/postSearchSTAC) request.

## Query parameters

- `bbox` number[]: The bounding box is provided as four numbers: * 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 WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84). For WGS84 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). Example: The bounding box of Switzerland in WGS 84 (from 5.96°E to 10.49°E and from 45.82°N to 47.81°N) would be represented in JSON as `[5.96, 45.82, 10.49, 47.81]` and in a query as `bbox=5.96,45.82,10.49,47.81`."
- `intersects` IntersectsFilter: Only returns items that intersect with the provided polygon.
  - `intersects` union
    - GeoJsonPoint
      - `type` 'Point', required
      - `coordinates` number[], required: For type "Point", the "coordinates" member is a single position. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
    - GeoJsonLineString
      - `type` 'LineString', required
      - `coordinates` array[], required: For type "LineString", the "coordinates" member is an array of two or more positions. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
        - number[]
    - GeoJsonPolygon
      - `type` 'Polygon', required
      - `coordinates` array[], required: For type "Polygon", the "coordinates" member MUST be an array of linear ring coordinate arrays. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
        - array[]
          - number[]
    - GeoJsonMultiPoint
      - `type` 'MultiPoint', required
      - `coordinates` array[], required: For type "MultiPoint", the "coordinates" member is an array of positions. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
        - number[]
    - GeoJsonMultiLineString
      - `type` 'MultiLineString', required
      - `coordinates` array[], required: For type "MultiLineString", the "coordinates" member is an array of LineString coordinate arrays. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
        - array[]
          - number[]
    - GeoJsonMultiPolygon
      - `type` 'MultiPolygon', required
      - `coordinates` array[], required: For type "MultiPolygon", the "coordinates" member is an array of Polygon coordinate arrays. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
        - array[]
          - array[]
            - number[]
- `datetime` string: Either a date-time or an interval, open or closed. Date and time expressions adhere to RFC 3339. Open intervals are expressed using double-dots. Examples: * A date-time: "2018-02-12T23:20:50Z" * A closed interval: "2018-02-12T00:00:00Z/2018-03-18T12:31:12Z" * Open intervals: "2018-02-12T00:00:00Z/.." or "../2018-03-18T12:31:12Z" Only features that have a temporal property that intersects the value of `datetime` are selected. When used as URL query argument, the value must be correctly url-encoded.
- `limit` integer: The `limit` parameter limits the number of results that are included in the response. To retrieve the next bunch of result, use the `next` link in the `links` section of the response. Minimum = 1. Maximum = 100. Default = 100.
- `ids` string[]: Array of Item ids to return. All other filter parameters that further restrict the number of search results are ignored
- `collections` string[]: Array of Collection IDs to include in the search for items. Only Items in one of the provided Collections will be searched.
- `sortby` string

## Response `200`

A feature collection.

- ItemsSearchGet: A GeoJSON FeatureCollection augmented with foreign members that contain values relevant to a STAC entity
  - `features` Item[], required
    - `id` string, required: Feature identifier (unique per collection)
    - `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
    - `assets` ItemAssets, required: List of Assets attached to this feature.
    - `bbox` number[], required: The bounding box is provided as four numbers: * 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 WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84). For WGS84 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). Example: The bounding box of Switzerland in WGS 84 (from 5.96°E to 10.49°E and from 45.82°N to 47.81°N) would be represented in JSON as `[5.96, 45.82, 10.49, 47.81]` and in a query as `bbox=5.96,45.82,10.49,47.81`."
    - `geometry` union, required
      - GeoJsonPoint
        - `type` 'Point', required
        - `coordinates` number[], required: For type "Point", the "coordinates" member is a single position. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
      - GeoJsonLineString
        - `type` 'LineString', required
        - `coordinates` array[], required: For type "LineString", the "coordinates" member is an array of two or more positions. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
          - number[]
      - GeoJsonPolygon
        - `type` 'Polygon', required
        - `coordinates` array[], required: For type "Polygon", the "coordinates" member MUST be an array of linear ring coordinate arrays. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
          - array[]
            - number[]
      - GeoJsonMultiPoint
        - `type` 'MultiPoint', required
        - `coordinates` array[], required: For type "MultiPoint", the "coordinates" member is an array of positions. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
          - number[]
      - GeoJsonMultiLineString
        - `type` 'MultiLineString', required
        - `coordinates` array[], required: For type "MultiLineString", the "coordinates" member is an array of LineString coordinate arrays. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
          - array[]
            - number[]
      - GeoJsonMultiPolygon
        - `type` 'MultiPolygon', required
        - `coordinates` array[], required: For type "MultiPolygon", the "coordinates" member is an array of Polygon coordinate arrays. The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84).
          - array[]
            - array[]
              - …
    - `properties` union, required: Provides the core metadata fields for a feature together with additional fields from the declared STAC extensions. An feature's temporal information is expressed either as a single point in time through `datetime`, or as a range through `start_datetime` and `end_datetime` (in which case `datetime` is `null`). One of these two forms is required. STAC extensions: * Every feature carries the mandatory core properties. * To use an extension's additional fields, list that extension in the `stac_extensions` array. * Declaring an extension may make some of its properties required. For example, the [Forecast extension](`https://github.com/stac-extensions/forecast`) requires `forecast:reference_datetime`.
      - object: Core STAC metadata fields for Items
        - `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
        - `datetime` string, date-time: RFC 3339 compliant datetime string
        - `start_datetime` string, date-time: RFC 3339 compliant datetime string
        - `end_datetime` string, date-time: RFC 3339 compliant datetime string
        - `title` string: Human readable title of the Feature
      - object: Properties from the [STAC Timestamps extension](https://github.com/stac-extensions/timestamps)
        - `expires` string, date-time: RFC 3339 compliant datetime string
      - object: Properties from the [STAC Forecast extension](https://github.com/stac-extensions/forecast)
        - `forecast:reference_datetime` string, date-time, required: RFC 3339 compliant datetime string
        - `forecast:horizon` string: ISO 8601 compliant duration
        - `forecast:duration` string: ISO 8601 compliant duration
        - `forecast:variable` string, nullable: Name of the model variable that corresponds to the data. The variables should correspond to the [CF Standard Names](https://cfconventions.org/Data/cf-standard-names/current/build/cf-standard-name-table.html), e.g. `air_temperature` for the air temperature.
        - `forecast:perturbed` boolean, nullable: Denotes whether the data corresponds to the control run (`false`) or perturbed runs (`true`). The property needs to be specified in both cases as no default value is specified and as such the meaning is "unknown" in case it's missing.
      - object: Properties from the [STAC CF extension](https://github.com/stac-extensions/cf.
        - `cf:standard_name` string, nullable: Corresponds to the CF Standard Name from the [CF Standard Name Table](https://cfconventions.org/Data/cf-standard-names/current/build/cf-standard-name-table.html).
        - `unit` string, nullable: Corresponds to the [CF units](https://cfconventions.org/cf-conventions/cf-conventions.html#units).
    - `stac_version` string, required
    - `stac_extensions` string[]: List of STAC extensions used by this feature. Properties that are not part of the default feature properties (`datetime`, `start_datetime`, `end_datetime`, `title`, `created`, `updated`) must be covered by one of the extensions listed here, otherwise the request is rejected. Additionally, when an extension is listed here, certain properties required by that extension must be present in the `properties` field. For example, when using the Forecast extension, the `forecast:reference_datetime` property is required.
    - `type` 'Feature', required: The GeoJSON type
  - `type` 'FeatureCollection', required
  - `links` Link[]: An array of links. Can be used for pagination, e.g. by providing a link with the `next` relation type.
    - `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

- `500`: The request was syntactically and semantically valid, but an error occurred while trying to act upon it

## Changes

- **2026-08-27** (v1) `c4917db7a83b`: 1 info
  - added the new optional `query` request parameter `sortby`
- **2026-08-26** (v1) `535770fce593`: 2 breaking, 12 warning, 1 info
  - removed the required property `allOf[#/components/schemas/itemsSearch]/features/items/allOf[#/components/schemas/itemBase]/properties/created` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/itemsSearch]/features/items/allOf[#/components/schemas/itemBase]/properties/updated` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/itemsSearch]/features/items/allOf[#/components/schemas/itemBase]/properties/cf:standard_name` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/itemsSearch]/features/items/allOf[#/components/schemas/itemBase]/properties/datetime` from the response with the `200` status
  - …11 more
- **2026-08-17** (v1) `11277d3dfca4`: 2 info
  - added the optional property `allOf[#/components/schemas/itemsSearch]/features/items/allOf[#/components/schemas/itemBase]/properties/cf:standard_name` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/itemsSearch]/features/items/allOf[#/components/schemas/itemBase]/properties/unit` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/geoadmin/apis/the-spatiotemporal-asset-catalog-api-for-data-geo-admin-ch/changes/search/get.md)

---

[API](https://skmtc.dev/geoadmin/apis/the-spatiotemporal-asset-catalog-api-for-data-geo-admin-ch.md) - [All operations](https://skmtc.dev/geoadmin/apis/the-spatiotemporal-asset-catalog-api-for-data-geo-admin-ch/llms.txt) - [OpenAPI document](https://skmtc.dev/geoadmin/apis/the-spatiotemporal-asset-catalog-api-for-data-geo-admin-ch/revisions/84c6b07189d4?raw)