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

# Search

`POST /archive/search`

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

- SearchPostResponse
  - `data` object, required
    - `id` string — Id of the search request
    - `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'
    - `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'
    - `created_at` string, date-time
    - `off_nadir_angle` number[]

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[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)