Skip to content
AgroSatAgroSat API

List fields

GET
/v1/fields
curl --request GET \
  --url 'https://api.agrosat.uz/v1/fields?limit=50&external_id=f-1001' \
  --header 'X-API-Key: <X-API-Key>'

Fields registered through the API, oldest first, one page at a time. Follow next_cursor until it is null. Costs no units.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
limit
integer
default: 50 >= 1 <= 200

Page size

cursor
string

next_cursor of the previous page

external_id
string

Example 

f-1001

Return only the field with this external_id

Responses

Section titled “Responses”

200

Section titled “200”

One page

Media typeapplication/json
object
success
required
boolean
data
required
Array<object>
object
id
required
string
external_id
required
string
name
required
string
area_ha
required

Area in hectares

number
status
required

Pending while history is prepared, then ready

string
Allowed values: pending ready
created_at
required
string format: date-time
next_cursor
required

Pass as cursor for the next page; null on the last page

string
nullable

Example 

{
  "success": true,
  "data": [
    {
      "id": "cmgz7k2qv0004l8p3a9d1x6rt",
      "external_id": "f-1001",
      "name": "North parcel 3",
      "area_ha": 41.53,
      "status": "pending",
      "created_at": "2026-04-28T09:14:03.512Z"
    }
  ],
  "next_cursor": null
}

400

Section titled “400”

Limit or cursor is not valid

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_request

invalid_request

{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "limit must be an integer in [1, 200]."
  }
}

401

Section titled “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."
  }
}

429

Section titled “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

Section titled “Headers”
Retry-After
integer
Example 
30

Seconds to wait before repeating the request