---
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`

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

---

[API](https://skmtc.net/azure/apis/agrifood-agfoodplatform.md) · [All operations](https://skmtc.net/azure/apis/agrifood-agfoodplatform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/agrifood-agfoodplatform/revisions/33cf1de6e0c4/schema)