Skip to content
AgroSatAgroSat API

Get a field

GET
/v1/fields/{id}
curl --request GET \
  --url https://api.agrosat.uz/v1/fields/cmgz7k2qv0004l8p3a9d1x6rt \
  --header 'X-API-Key: <X-API-Key>'

One field with its readiness status. Poll it after registration until status is ready. Costs no units.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Example 

cmgz7k2qv0004l8p3a9d1x6rt

Field id returned by registration

Responses

Section titled “Responses”

200

Section titled “200”

The field

Media typeapplication/json
object
success
required
boolean
data
required
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

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"
  }
}

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."
  }
}

404

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

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