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

Mobile

Endpoints for mobile application (Expo) with custom domain authentication

Operations

Get forms for mobile app user

Request

Retrieves all forms accessible to a mobile app user based on their company context.

Mobile Authentication: Uses custom domain authentication (auth.hydrobit.ag) for Expo mobile app.

Requires JWT token from mobile authentication in the Authorization header.

  • If subtype=tasks, returns all task forms for the user
  • Otherwise, returns monitoring forms based on user access permissions
Security
bearerAuth
Query
auth0Idstringrequired

User identifier

Example: auth0Id=user_123456789
companyIdstringrequired

Company identifier

Example: companyId=comp_12345
typestring

Form type filter

Example: type=inspection
subtypestring

Form subtype (e.g., 'tasks' for task forms)

Example: subtype=tasks
curl -i -X GET \
  'https://docs.hydrobit.ag/_mock/spec/openapi/api/control/mobile/forms/getForms?auth0Id=user_123456789&companyId=comp_12345&type=inspection&subtype=tasks' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Forms retrieved successfully

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

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

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