Download Your First Image

Use this quickstart to fetch your first composite image with reliable pre-checks. This page intentionally stays workflow-first; full endpoint contracts stay in Processing / download endpoints.

Before You Start

• Have an existing order and target date context from Create your first order.
• Keep request settings stable (AOI mode, model, constellations, EPSG, bands).
• Review Download with the API for larger automation patterns.

Minimal Request Example

1. Validate single-date fulfillability:

curl -X POST "https://api.clearsky.vision/api/satelliteimages/process/composite/available" \
  -H "x-api-key: $CLEARSKY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Wkt": "POLYGON((9.87 56.47,10.19 56.47,10.19 56.28,9.87 56.28,9.87 56.47))",
    "Date": "2025-04-03T00:00:00Z",
    "Model": "Stratus2",
    "SatelliteConstellations": ["Sentinel1", "Sentinel2", "Landsat89"],
    "EpsgProjection": 32632,
    "Bandnames": "rgb"
  }'

2. Estimate processing cost with the same payload settings:

curl -X POST "https://api.clearsky.vision/api/satelliteimages/process/composite/estimate" \
  -H "x-api-key: $CLEARSKY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Wkt": "POLYGON((9.87 56.47,10.19 56.47,10.19 56.28,9.87 56.28,9.87 56.47))",
    "Date": "2025-04-03T00:00:00Z",
    "Resolution": 10,
    "EpsgProjection": 32632,
    "Model": "Stratus2",
    "SatelliteConstellations": ["Sentinel1", "Sentinel2", "Landsat89"],
    "Bandnames": "rgb"
  }'

3. Request image bytes:

curl -X POST "https://api.clearsky.vision/api/satelliteimages/process/composite" \
  -H "x-api-key: $CLEARSKY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "Wkt": "POLYGON((9.87 56.47,10.19 56.47,10.19 56.28,9.87 56.28,9.87 56.47))",
    "Date": "2025-04-03T00:00:00Z",
    "Resolution": 10,
    "EpsgProjection": 32632,
    "Model": "Stratus2",
    "SatelliteConstellations": ["Sentinel1", "Sentinel2", "Landsat89"],
    "Bandnames": "rgb"
  }' --output clearsky_first_image.tif

Recommended call sequence:

1. Discover candidate dates with POST /api/satelliteimages/search/available.
2. Validate exact single-date fulfillment with POST /api/satelliteimages/process/composite/available.
3. Use the same validated request shape for estimate and process.

Common Failure and Fix

• Failure: availability passes but estimate or process fails.
• Fix: ensure all calls use the same date, AOI mode, model, constellations, and output settings.

For 429/5xx, retry with backoff instead of immediate repeated calls.

Next Step

• Expand to automation in End-to-end Python workflow.
• Use CRS / EPSG / UTM guidance before scaling to larger AOIs.