Skip to content

Hydrobit API (2.0.0)

Comprehensive API documentation for the Hydrobit platform.

This API enables management of forms, records, workers, projects, and related data within Hydrobit.

Authentication

  • User endpoints: Require a JWT in the Authorization header (Bearer token).

Features

  • Form management and record submission
  • Project and sector data retrieval
  • Worker management and operations
  • Production session and record management

Note: API access is available for Corporate accounts. For access or support, contact support@hydrobit.ag.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
URL
https://hydrobit.ag
Hydrobit Support
support@hydrobit.ag
License
Proprietary
Languages
Servers
Mock server
https://docs.hydrobit.ag/_mock/spec/openapi/
Production server
https://api.hydrobit.ag/
IoT server
https://iot.hydrobit.ag/
MQTT over WebSocket endpoint
wss://iot.hydrobit.ag/

Forms

Endpoints for form management and record submission

Operations

Projects

Endpoints for project and sector data retrieval

Operations

Workers

Endpoints for worker management and operations

Operations

Production Sessions

Endpoints for managing production sessions (open, close, update)

Operations

Production Records

Endpoints for creating and managing production records

Operations

Phytosanitary

Endpoints for phytosanitary monitoring and analysis (pest/disease tracking)

Operations

Weather

Endpoints for weather and climate data retrieval

Operations

Get weather time series for local range

Request

Returns weather and microclimate time series for a project within a local-time range (Leaf-style). Auth via API token in x-api-key.

Security
apiKeyAuth
Query
projectIdstringrequired
fromstring(date-time)required

Start datetime in local timezone (ISO 8601)

tostring(date-time)required

End datetime in local timezone (ISO 8601)

timezonestringrequired

IANA timezone (e.g., America/Mexico_City)

Bodyapplication/json

Optional alternative to query params (for complex queries)

projectIdstringrequired

Project identifier

Example: "proj_123"
fromstring(date-time)required

Start datetime in local timezone (ISO 8601)

Example: "2025-10-01T00:00:00-06:00"
tostring(date-time)required

End datetime in local timezone (ISO 8601)

Example: "2025-10-09T23:59:59-06:00"
timezonestringrequired

IANA timezone for interpretation of local range

Example: "America/Mexico_City"
curl -i -X GET \
  'https://docs.hydrobit.ag/_mock/spec/openapi/api/iot/weather?projectId=string&from=2019-08-24T14%3A15%3A22Z&to=2019-08-24T14%3A15%3A22Z&timezone=string' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -d '{
    "projectId": "proj_123",
    "from": "2025-10-01T00:00:00-06:00",
    "to": "2025-10-09T23:59:59-06:00",
    "timezone": "America/Mexico_City"
  }'

Responses

Weather time series

Bodyapplication/json
statusstring
Example: "success"
dataArray of objects(WeatherPoint)
Response
application/json
{
  "status": "success",
  "data": [
    { … }
  ]
}

Plant

Endpoints for plant monitoring, growth, and health data

Operations

Irrigation

Endpoints for irrigation control, logs, and automation

Operations

IoT Endpoint

Endpoints for IoT devices, telemetry, and field data integration

Operations