Archive Ordering Workflow

Three steps: (1) Create search → (2) Evaluate results → (3) Create order (pipeline).

Interactive API Reference

Try these endpoints interactively in the REST API Reference:

• Search Archive (POST) - Create archive search
• Get Search Results - Retrieve search results
• Create Pipeline - Place order from search results

Click "Authorize" to enter your API key, then "Try it out" to test the endpoints live!

1) Create search

POST https://api.skywatch.co/earthcache/archive/search

Consider the websocket endpoint

The websocket search endpoint allows you to stream data as its received, and will improve your time to first result.

Body: AOI Polygon, start_date, end_date (past dates), one resolution category (low|medium|high|very_high), optional off_nadir_angle, order_by (coverage|date|resolution|cost). Record search_id.

Resolution categories (Standard sources)

• low (8.01–30 m): Sentinel-2 (10 m)
• medium (1.26–8 m): SPOT (1.5 m)
• high (0.5–1.25 m): Maxar-50cm, Pleiades, SkySat (0.5 m)
• very_high (0.01–0.49 m): Maxar-30cm/15cm, Pleiades-Neo, HD-15, UrbanSky, EagleView, Vexcel (per product specs)

2) Evaluate results

GET https://api.skywatch.co/earthcache/archive/search/{{search_id}}/search_results

Parse each item: result_id, source, product_name, coverage %, area km², cost, cloud %, preview/thumbnail URLs, and associated offering/config IDs. Choose a result_id.

3) Create order

Provide search_id + chosen search_results: ["{{result_id}}"], matching dates/AOI and a max_cost ≥ result cost. Use project id.

• Output must be geotiff with the platform output id (fixed).
• Optional tags, e.g., {"label":"billing_group","value":"Project_A"} (exact label).