---
title: "POST /scenes/stac-collections/{collectionId}:search"
method: POST
path: "/scenes/stac-collections/{collectionId}:search"
tags: ["Scenes"]
---

# POST /scenes/stac-collections/{collectionId}:search

`POST /scenes/stac-collections/{collectionId}:search`

## Request

- Base URL: `{endpoint}`
- URL: `{endpoint}/scenes/stac-collections/{collectionId}:search`
- Auth: API key in header `Authorization`

Search for STAC items by collection id, bbox, intersecting geometry, start and end datetime.

## Path parameters

- `collectionId` string, required

## Query parameters

- `maxpagesize` integer
- `skip` integer
- `api-version` string, required

## Request body

- SearchItemsQuery: Search stac Items parameters.
  - `credentials` OAuthClientCredentials: AuthCredentials abstract base class for Auth Purpose.
    - `kind` 'OAuthClientCredentials' | 'ApiKeyAuthCredentials', required: Enum for different types of AuthCredentials supported.
    - `clientId` string, required: ClientId associated with the provider.
    - `clientSecret` KeyVaultProperties, required: Properties of the key vault.
      - `keyVaultUri` string, required: Uri of the key vault.
      - `keyName` string, required: Name of Key Vault key.
      - `keyVersion` string, required: Version of Key Vault key.
  - `startDateTime` string, date-time, required: Start datetime of the time interval in which to search for Items.
  - `endDateTime` string, date-time, required: End datetime of the time interval in which to search for Items.
  - `intersects` GeoJsonObject: GeoJSON (For more details: https://geojson.org/). Note: Coordinates are expected in [Longitude, Latitude] format.
    - `type` 'Point' | 'Polygon' | 'MultiPolygon', required: GeoJSON object type.
  - `bbox` number[]: Only items that have a geometry that intersects the bounding box are selected. The bounding box is provided as four numbers. The coordinate reference system of the values is WGS84 longitude/latitude.
  - `itemIds` string[]: Array of item ids to return.

## Response `200`

Success

- SearchItemsResponse: Paged response contains list of items and next property to get the next set of results.
  - `items` StacItem[], required: List of items.
    - `stacVersion` string, required: The STAC version the Stac Item implements.
    - `stacExtensions` string[]: A list of extensions the Stac Item implements.
    - `id` string, required: Provider identifier. Globally unique ID by Data provider.
    - `type` string, required: Type of the GeoJSON Object. It's value is always Feature.
    - `geometry` object: Defines the full footprint of the asset represented by this item. Its a GeoJSON geometry.
    - `bbox` number[]: Bounding box of the item.
    - `properties` object, required: A dictionary of additional metadata for the item.
    - `links` StacItemLink[], required: List of link objects to resources and related URLs.
      - `href` string, required: The actual link in the format of an URL.
      - `rel` string, required: Relationship between the current document and the linked document.
      - `type` string: Media type of the referenced entity.
      - `title` string: A human readable title to be used in rendered displays of the link.
    - `assets` object, required: Dictionary of asset objects, each with a unique key.
    - `collection` string: The id of the STAC Collection this Stac Item references.
  - `nextLink` string: URL to do the POST request with same filters, to get next set of items.

## Other responses

- `default`: Error

## Changes

- **2026-07-13** (2021-03-31-preview) `33cf1de6e0c4`: 1 info
  - api operation id `Scenes_SearchFeatures` removed and replaced with `Scenes_SearchItems`
- **2026-07-13** (2021-03-31-preview) `aae0a90ec457`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/azure/apis/agrifood-agfoodplatform/changes/scenes/stac-collections/:collectionId:search/post.md)

---

[API](https://skmtc.dev/azure/apis/agrifood-agfoodplatform.md) - [All operations](https://skmtc.dev/azure/apis/agrifood-agfoodplatform/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/agrifood-agfoodplatform/revisions/33cf1de6e0c4?raw)
