Skip to main content
GET
See Land hierarchy for when to use blocks vs field-level only.

Authentication

Requires a key with the fields:read scope. See Authentication.

Path parameters

id
string
required
Farm UUID.
fieldId
string
required
Field UUID.

Query parameters

status
string
Filter by block status: planned, planted, established, mature, declined, harvested, removed.
cropId
string
Filter to blocks of a specific crop (UUID).

Response

data
array
Array of block objects. Soft-deleted blocks are excluded.

Errors

StatusWhen
400 INVALID_ID{id} or {fieldId} is not a valid UUID
400 VALIDATION_ERRORInvalid query parameter value
401Missing, malformed, expired, or revoked API key
403 INSUFFICIENT_SCOPEKey lacks fields:read scope
404 NOT_FOUNDFarm or field doesn’t exist or belongs to another user
429 RATE_LIMIT_EXCEEDEDPer-user rate limit reached
5xxServer error