Imagery dates

GET /v1/fields/{id}/dates lists the days with imagery over a field in a window. Use it to pick a date for an image, or to show a timeline before you request statistics.

Python and JavaScript examples reuse API, session, headers and the field id from the Quickstart.

Request

Parameter	Required	Notes
from	yes	First day, YYYY-MM-DD.
to	yes	Last day, YYYY-MM-DD, on or after from and at most 366 days later.
source	no	sentinel-2 (default) or planet.

curl

curl "https://api.agrosat.uz/v1/fields/cmgz7k2qv0004l8p3a9d1x6rt/dates?from=2026-04-01&to=2026-06-30" \
  -H "X-API-Key: $AGROSAT_API_KEY"

Python

r = session.get(
    f"{API}/fields/{field_id}/dates",
    params={"from": "2026-04-01", "to": "2026-06-30"},
    timeout=60,
)
dates = r.json()["data"]["dates"]
clear = [d["date"] for d in dates if (d["scene_cloud_cover"] or 0) < 0.2]

JavaScript

const url = new URL(`${API}/fields/${fieldId}/dates`);
url.search = new URLSearchParams({ from: "2026-04-01", to: "2026-06-30" });
const { data } = await (await fetch(url, { headers })).json();
const clear = data.dates.filter((d) => (d.scene_cloud_cover ?? 0) < 0.2).map((d) => d.date);

Response

Dates come newest first:

{
  "success": true,
  "data": {
    "field_id": "cmgz7k2qv0004l8p3a9d1x6rt",
    "dates": [
      { "date": "2026-05-14", "scene_cloud_cover": 0.0213 },
      { "date": "2026-05-09", "scene_cloud_cover": 0.874 },
      { "date": "2026-05-04", "scene_cloud_cover": 0.0571 }
    ]
  }
}

scene_cloud_cover is the cloud cover of the whole satellite scene, as a fraction from 0 to 1, or null when the provider did not report it. A scene covers a large area, so a cloudy scene can still show your field clearly, and a clear scene can have a cloud right over it.

Cloud over the field itself

For the share of the field that was cloudy on a date, read cloud_fraction and valid_fraction from statistics. Use scene_cloud_cover only as a quick first filter.

Cost

Each successful call costs 1 unit, whatever the length of the window. A 202 while data is being prepared costs nothing; see Field readiness.

Next steps

Index imagesRender the index for one of these dates.

Index statisticsStatistics for every date in a window at once.