Create Your First Order

Use this quickstart to place your first order with minimal setup and no schema guesswork. This page teaches the shortest safe path. Full payload design rules stay in Create an order with the API.

Before You Start

• Get your API key from Get credentials / API key.
• Confirm endpoint behavior in Tasking / order endpoints.
• Decide AOI mode first (Wkt/GeoJson or tile/minitile) using Choose an order type.

Required headers:

x-api-key: <your-api-key>
Content-Type: application/json

Minimal Request Example

Step 1: estimate before create.

curl -X POST "https://api.clearsky.vision/api/tasking/orders/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))",
    "SatelliteConstellations": ["Sentinel1", "Sentinel2", "Landsat89"],
    "Model": "Stratus2",
    "StorageMonths": 1,
    "ApiRequests": 1,
    "ImageFrequency": 3,
    "ReferenceDate": "2025-01-01",
    "From": "2025-04-01",
    "To": null
  }'

Step 2: if estimate is acceptable, send the same payload to POST /api/tasking/orders.

Step 3: verify order creation with GET /api/tasking/orders.

Common Failure and Fix

• Failure: 400 from payload mismatch between estimate and orders.
• Fix: reuse the exact validated estimate payload for create.

Also verify:

• only one AOI mode is sent,
• required fields match model/order mode,
• key is valid if 401/403 appears.

Next Step

• Continue with Check order status.
• Then gate downloads using Check availability.
• Move to Download your first image.