Blocks
List blocks
List blocks on a field. Blocks are variety/management cohorts inside a field.
GET
Authentication
Requires a key with thefields:read scope. See Authentication.
Path parameters
Farm UUID.
Field UUID.
Query parameters
Filter by block status:
planned, planted, established, mature, declined, harvested, removed.Filter to blocks of a specific crop (UUID).
Response
Array of block objects. Soft-deleted blocks are excluded.
Errors
| Status | When |
|---|---|
400 INVALID_ID | {id} or {fieldId} is not a valid UUID |
400 VALIDATION_ERROR | Invalid query parameter value |
401 | Missing, malformed, expired, or revoked API key |
403 INSUFFICIENT_SCOPE | Key lacks fields:read scope |
404 NOT_FOUND | Farm or field doesn’t exist or belongs to another user |
429 RATE_LIMIT_EXCEEDED | Per-user rate limit reached |
5xx | Server error |