List imagery dates

GET

/v1/fields/{id}/dates

curl --request GET \
  --url 'https://api.agrosat.uz/v1/fields/cmgz7k2qv0004l8p3a9d1x6rt/dates?from=2026-04-01&to=2026-06-30&source=sentinel-2' \
  --header 'X-API-Key: <X-API-Key>'

• Production

Dates with imagery over the field in the window, newest first, with the cloud cover of the whole scene. Costs 1 unit.

Authorizations

• apiKey

Parameters

Path Parameters

id

required

string

Example

cmgz7k2qv0004l8p3a9d1x6rt

Field id returned by registration

Query Parameters

from

required

string format: date

Example

2026-04-01

First day of the window

to

required

string format: date

Example

2026-06-30

Last day, at most 366 days after from

source

string

Allowed values: sentinel-2 planet

sentinel-2 (default) or planet. Planet requires a separate agreement.

Responses

200

Dates in the window

Media typeapplication/json

object

success

required

boolean

data

required

object

field_id

required

string

dates

required

Newest first

Array<object>

object

date

required

string format: date

scene_cloud_cover

required

Cloud cover of the whole satellite scene, 0 to 1

number

nullable

Example

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

Headers

X-AgroSat-Units

integer

Example

1

Units this response consumed

202

Data is being prepared. Repeat the request after Retry-After seconds. Not billed.

Media typeapplication/json

object

success

required

boolean

error

required

object

code

required

string

Allowed values: invalid_api_key rate_limited field_not_found invalid_geometry field_too_large duplicate_geometry external_id_conflict quota_exceeded invalid_index source_not_enabled invalid_date_range date_out_of_range no_imagery_for_date data_pending invalid_request not_found internal_error

message

required

English text; may change, branch on code

string

existing_field_id

Field already holding this external_id or geometry (409 only)

string

Examples

Exampledata_pending

data_pending

{
  "success": false,
  "error": {
    "code": "data_pending",
    "message": "The scene catalog for this window is being prepared."
  }
}

Headers

Retry-After

integer

Example

30

Seconds to wait before repeating the request

400

The window is not acceptable

Media typeapplication/json

object

success

required

boolean

error

required

object

code

required

string

Allowed values: invalid_api_key rate_limited field_not_found invalid_geometry field_too_large duplicate_geometry external_id_conflict quota_exceeded invalid_index source_not_enabled invalid_date_range date_out_of_range no_imagery_for_date data_pending invalid_request not_found internal_error

message

required

English text; may change, branch on code

string

existing_field_id

Field already holding this external_id or geometry (409 only)

string

Examples

invalid_date_range

{
  "success": false,
  "error": {
    "code": "invalid_date_range",
    "message": "to must be on or after from, at most 366 days apart."
  }
}

date_out_of_range

{
  "success": false,
  "error": {
    "code": "date_out_of_range",
    "message": "The earliest date available to this organization is 2024-01-01."
  }
}

invalid_request

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "from must be YYYY-MM-DD."
  }
}

401

X-API-Key is missing, unknown, revoked or expired, or the API is not enabled.

Media typeapplication/json

object

success

required

boolean

error

required

object

code

required

string

Allowed values: invalid_api_key rate_limited field_not_found invalid_geometry field_too_large duplicate_geometry external_id_conflict quota_exceeded invalid_index source_not_enabled invalid_date_range date_out_of_range no_imagery_for_date data_pending invalid_request not_found internal_error

message

required

English text; may change, branch on code

string

existing_field_id

Field already holding this external_id or geometry (409 only)

string

Examples

Exampleinvalid_api_key

invalid_api_key

{
  "success": false,
  "error": {
    "code": "invalid_api_key",
    "message": "Missing or invalid API key."
  }
}

403

Source or quota not available

Media typeapplication/json

object

success

required

boolean

error

required

object

code

required

string

Allowed values: invalid_api_key rate_limited field_not_found invalid_geometry field_too_large duplicate_geometry external_id_conflict quota_exceeded invalid_index source_not_enabled invalid_date_range date_out_of_range no_imagery_for_date data_pending invalid_request not_found internal_error

message

required

English text; may change, branch on code

string

existing_field_id

Field already holding this external_id or geometry (409 only)

string

Examples

source_not_enabled

{
  "success": false,
  "error": {
    "code": "source_not_enabled",
    "message": "PlanetScope imagery is not enabled for this organization."
  }
}

quota_exceeded

{
  "success": false,
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly unit quota reached (10000 of 10000)."
  }
}

404

No such field in your organization

Media typeapplication/json

object

success

required

boolean

error

required

object

code

required

string

Allowed values: invalid_api_key rate_limited field_not_found invalid_geometry field_too_large duplicate_geometry external_id_conflict quota_exceeded invalid_index source_not_enabled invalid_date_range date_out_of_range no_imagery_for_date data_pending invalid_request not_found internal_error

message

required

English text; may change, branch on code

string

existing_field_id

Field already holding this external_id or geometry (409 only)

string

Examples

Examplefield_not_found

field_not_found

{
  "success": false,
  "error": {
    "code": "field_not_found",
    "message": "Field not found."
  }
}

429

Over the per-key request rate. Not billed.

Media typeapplication/json

object

success

required

boolean

error

required

object

code

required

string

Allowed values: invalid_api_key rate_limited field_not_found invalid_geometry field_too_large duplicate_geometry external_id_conflict quota_exceeded invalid_index source_not_enabled invalid_date_range date_out_of_range no_imagery_for_date data_pending invalid_request not_found internal_error

message

required

English text; may change, branch on code

string

existing_field_id

Field already holding this external_id or geometry (409 only)

string

Examples

Examplerate_limited

rate_limited

{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}

Headers

Retry-After

integer

Example

30

Seconds to wait before repeating the request