---
title: "Search"
method: GET
path: "/stac/search"
tags: ["SpatioTemporal Asset Catalog (STAC) API"]
---

# Search

`GET /stac/search`

STAC search operation with query parameters.

## Query parameters

- `api-version` string, required
- `collections` string[]
- `ids` string[]
- `bbox` number[]
- `intersects` string
- `datetime` string
- `limit` integer
- `sign` 'true' | 'false'
- `duration` integer
- `query` string
- `sortby` string
- `fields` string
- `filter` string
- `filter-crs` string
- `filter-lang` 'cql-json' | 'cql2-json' | 'cql2-text'
- `token` string

## Response `200`

The request has succeeded.

- StacItemCollection — Base type for STAC items and collections with discriminator.
  - `type` string, required — Discriminator property for StacItemOrStacItemCollection.
  - `stac_version` string — Stac Version
  - `links` StacLink[] — Links to related resources and endpoints.
    - `rel` string — The relationship type of the link.
    - `title` string — The title of the link.
    - `type` 'image/tiff; application=geotiff' | 'image/jp2' | 'image/png' | 'image/jpeg' | 'image/jpg' | 'image/webp' | 'application/x-binary' | 'application/xml' | 'application/json' | 'application/geo+json' | 'text/html' | 'text/plain' | 'application/x-protobuf' — The MIME type of the linked resource.
    - `href` string, required — The URL of the link.
    - `hreflang` string — The language of the linked resource.
    - `length` integer — The length of the linked resource.
    - `method` 'GET' | 'POST' — Specifies the HTTP method that the resource expects. Default: GET.
    - `headers` object — Object key-value pairs that map to headers. Example: { "Accept": "application/json" }.
    - `body` object — For POST requests, the resource can specify the HTTP body as a JSON object.
    - `merge` boolean — Indicates whether the client is expected to merge the body value into the current request body before following the link. This is only valid when the server is responding to a POST request. Default: false.
  - `msft:_created` string, date-time — MSFT Created
  - `msft:_updated` string, date-time — MSFT Updated
  - `msft:short_description` string — MSFT Short Description
  - `stac_extensions` string[] — URLs to STAC extensions implemented by this STAC resource.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2025-04-30-preview) `42447be18bc5` — 2 info
  - added the new optional `query` request parameter `filter-crs`
  - added the new optional `query` request parameter `filter-lang`
- **2026-02-19** (2025-04-30-preview) `28e8cb365289` — 1 breaking, 1 info
  - removed the success response with the status `204`
  - api operation id `StacSearchOperations_Get` removed and replaced with `StacSearch_Get`
- **2025-05-15** (2025-04-30-preview) `00cbc3d6d8e0` — 2 warning, 2 info
  - deleted the `query` request parameter `filter-crs`
  - deleted the `query` request parameter `filter-lang`
  - api operation id `StacSearch_Get` removed and replaced with `StacSearchOperations_Get`
  - added the success response with the status `204`

[Change history](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/changes/stac/search/get.md)

---

[API](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer.md) · [All operations](https://skmtc.dev/azure/apis/orbital-microsoft-planetarycomputer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/orbital-microsoft-planetarycomputer/revisions/42447be18bc5/schema)