Zenth Agritech API Reference

v2.4.1 • Stable

The Zenth Agritech REST API provides programmatic access to our global precision agriculture network. Manage fields, retrieve real-time sensor telemetry, automate irrigation, and access AI-driven yield forecasts. All endpoints return JSON and support cross-origin requests.

Note: Production access requires an Enterprise API license. Sandbox environments are available for developer testing with simulated IoT device data.

Authentication

Authenticate requests using Bearer tokens or legacy API keys. Tokens must be passed in the `Authorization` header.

curl https://api.aevumzenth.com/agritech/v1/fields \\
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \\
  -H "Content-Type: application/json"

import requests

headers = {
    "Authorization": "Bearer <YOUR_ACCESS_TOKEN>",
    "Content-Type": "application/json"
}

response = requests.get("https://api.aevumzenth.com/agritech/v1/fields", headers=headers)
print(response.json())

Fields & Geofences

GET /v1/fields

Retrieve a paginated list of all monitored fields associated with your organization. Supports filtering by region, status, and last sync timestamp.

Parameter	Type	Description
`limit`	integer	Max results (default: 50, max: 200)
`cursor`	string	Pagination cursor from previous response
`region`	string	Filter by ISO 3166-2 region code

GET /v1/fields/{field_id}/soil-metrics

Fetch real-time and historical soil telemetry. Data aggregates readings from Zenth IoT node clusters (moisture, NPK, pH, EC, temperature).

Parameter	Type	Description
`field_id`Required	string	UUID of the target field
`metrics`	array	Comma-separated: moisture, nkph, ph, temp
`granularity`	string	Time window: `1h`, `6h`, `24h`, `7d`

{
  "status": "success",
  "data": {
    "field_id": "f7e3a9c1-88b2-4d01-a9f5-11c2e9b44d0a",
    "last_sync": "2026-05-18T14:32:00Z",
    "telemetry": {
      "moisture": { "value": 42.3, "unit": "%", "trend": "stable" },
      "nkph": { "value": 1.8, "unit": "mmol/L", "alert": false },
      "ph": { "value": 6.4, "optimal_range": [6.0, 7.0] }
    }
  }
}

POST /v1/irrigation/execute

Enterprise Role Required • Dispatch commands to connected irrigation controllers. Supports drip, pivot, and smart valve systems.

Body Parameter	Type	Description
`zone_id`Required	string	Target irrigation zone UUID
`action`Required	enum	`start`, `stop`, `schedule`
`duration_sec`	integer	Override duration (ignored if action=schedule)
`dry_run`	boolean	Simulate execution without triggering hardware

Error Handling

The API uses conventional HTTP status codes. Error responses include a structured JSON body with machine-readable codes.

Code	Status	Description
`400`	Bad Request	Malformed JSON or missing required parameters
`401`	Unauthorized	Invalid or expired authentication token
`403`	Forbidden	Insufficient permissions for requested resource
`429`	Too Many Requests	Rate limit exceeded. See X-RateLimit-Reset header
`503`	Service Unavailable	Temporary upstream sensor network maintenance

Webhooks: For asynchronous events (e.g., sensor alerts, batch job completion), configure webhook endpoints in the Agritech Dashboard. All payloads are signed with SHA256 using your webhook secret.

Rate Limits

API access is governed by tier-based rate limits to ensure global telemetry stability.

Developer/Sandbox: 100 requests / minute, 1,000 / day
Standard: 1,000 requests / minute, burst up to 2,500
Enterprise: Custom throughput with dedicated sensor channels

Response headers include: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

SDKs & Tools

Official client libraries are maintained by the Zenth Developer Platform team.

pip install zenth-agritech npm install @aevumzenth/agritech go get github.com/aevumzenth/agritech-go

Need integration support or want to discuss custom data pipelines? Contact our developer success team at api-support@aevumzenth.com