---
title: "Search Archive"
method: POST
path: "/data/search"
tags: ["archiveSearch"]
---

# Search Archive

`POST /data/search`

Search the satellite imagery archive for available scenes matching your criteria. Returns scenes with metadata including cloud cover, resolution, and offering IDs.

## Request body

- SearchResource
  - `location` union
    - Polygon
      - `type` 'Polygon', required
      - `coordinates` array[], required
        - array[]
          - number[]
      - `bbox` number[]
    - object
      - `ref` object, required
        - `uri` string, uri, required
  - `start_date` string, date — Starting capture date of interest
  - `end_date` string, date — Ending capture date of interest
  - `resolution` union — Resolution of returned results
    - string[]
    - 'low' | 'medium' | 'high' | 'very_high'
  - `coverage` number — Percentage of location covered by search result
  - `interval_length` number — Length of interval in days to group search results by
  - `order_by` union — Sort order of returned search results
    - string[]
    - 'resolution' | 'cost' | 'coverage' | 'date' | '-resolution' | '-cost' | '-coverage' | '-date'
  - `off_nadir_angle` number[] — Array containing two numerical values representing the minimum and maximum off-nadir angles, in degrees, within [-90, 90].

## Response `200`

Success

- SearchResponse
  - `data` object[], required
    - `id` string — Id of the search result
    - `location` SupportedGeojsonGeometry — GeoJSON Geometry supported by EarthCache™
      - `type` 'Polygon', required — The type of GeoJSON object.
      - `coordinates` array[], required
        - array[]
          - unknown[]
            - unknown
      - `bbox` number[]
    - `intersection` SupportedGeojsonGeometry — GeoJSON Geometry supported by EarthCache™
      - `type` 'Polygon', required — The type of GeoJSON object.
      - `coordinates` array[], required
        - array[]
          - unknown[]
            - unknown
      - `bbox` number[]
    - `start_time` string, date-time — Start date and time of capture
    - `end_time` string, date-time — End date and time of capture
    - `preview_uri` string, uri — Preview image of search result
    - `thumbnail_uri` string, uri — 100 x 100 pixel thumbnail image of search result
    - `resolution` number — Resolution in metres of search result
    - `source` string — Name of source provider of search result
    - `product_name` string — Source provider product name of search result
    - `location_coverage_percentage` number — Percentage that search result covers search location
    - `area_sq_km` number — Area in square km that search result covers search location
    - `minimum_area_sq_km` number — Minimum area in square km allowed to order
    - `price_per_sq_km` number — Price per square km
    - `cost` union
      - string — Appears as 'Upgrade your plan for price' on medium or high resolution search results for test plan users
      - number — Cost if search location were to be processed and delivered from this search result
    - `result_cloud_cover_percentage` number — Percentage that search result is covered by clouds
    - `off_nadir_angle` number
  - `pagination` object
    - `per_page` integer, required
    - `cursor` object, required
      - `next` integer
      - `self` integer
    - `total` integer, required
    - `count` integer, required

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.net/skywatch/apis/api-specification.md) · [All operations](https://skmtc.net/skywatch/apis/api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skywatch/api-specification/revisions/51f7c5a8d15d/schema)