Skip to content
docs

A probe's watering log

GET /modules/{moduleId}/irrigation/events
  • Scope irrigation:read
  • API key x-api-key
  • Base URL https://api.hub.akuasense.com/v1

Mandatory window, matched on OVERLAP rather than on startedAt alone: a watering that started the evening before and ended in the morning does belong to the day you are looking at.

Path parameters

  • moduleId integer required

Query parameters

  • from string date-time required

    Start of the window (ISO 8601). Required.

  • to string date-time required

    End of the window (ISO 8601). Required, and later than from.

Response

200

Waterings overlapping the window, most recent first

  • module_id integer
  • from string date-time
  • to string date-time
  • data array of IrrigationEvent

    One water application, at the probe. Millimetres are FROZEN at write time and never recomputed on read.

    Show 18 attributes Hide attributes
    • id integer
    • moduleId integer
    • scheduleId integer nullable

      Schedule this row is an occurrence of, if any.

    • isDetached boolean

      Schedule occurrence corrected by hand: the nightly regeneration will never touch it again.

    • startedAt string date-time
    • durationMin integer nullable

      Duration in minutes. null in depth_mm/volume_m3 mode when no duration was declared.

    • endedAt string date-time nullable

      Computed (startedAt + durationMin), not stored. null if the duration is unknown.

    • inputMode string

      How the application is declared. duration requires NO configuration (it is the universal fallback mode) but only yields a dose once the flow rate is known; depth_mm is taken as is; volume_m3 requires the irrigated area.

      Values: durationdepth_mmvolume_m3
    • inputDepthMm number nullable

      Value entered in depth_mm mode, in mm.

    • inputVolumeM3 number nullable

      Value entered in volume_m3 mode, in m³.

    • waterMm number nullable

      Dose over the TOTAL AREA, in mm — the figure comparable to rainfall, ETc or the water meter. null = cannot be converted as things stand; the row stays valid and is shown with its duration.

    • waterMmWetted number nullable

      Dose in the WETTED ZONE (= waterMm ÷ fw), in mm — where the probe is installed, and therefore what explains the observed rise in VWC. null when fw is 1: both figures would be identical.

    • configSnapshot IrrigationConfigSnapshot nullable

      Snapshot of the parameters ACTUALLY USED to compute this row, frozen at write time. Distinct from the setup history: the history says which equipment was in place on a given date, the snapshot says what was actually used — the two can legitimately differ if the setup has been corrected since.

      Show 8 attributes Hide attributes
      • installationId integer nullable

        Setup version used.

      • scope string nullable

        Scope this setup came from.

        Values: moduleparcelnull
      • system string nullable
      • flowMmPerH number nullable

        Application rate used, in mm/h.

      • fractionWetted number nullable

        Wetted soil fraction used (0 < fw ≤ 1).

      • fractionWettedIsDefault boolean

        true = system default, not entered.

      • irrigatedAreaM2 number nullable

        Irrigated area used, in m².

      • computedAt string date-time
    • status string

      planned = scheduled, done = done, skipped = cancelled (never shown on charts).

      Values: planneddoneskipped
    • source string

      Where the row comes from. manual = entered in the hub · schedule = occurrence materialized by a schedule · api = this API · mcp = AI assistant. Read-only: the source is set by whichever surface writes the row.

      Values: manualscheduleapimcp
    • verifiedAt string date-time nullable

      null = nobody confirmed this watering (occurrence auto-confirmed by a schedule).

    • note string nullable
    • createdAt string date-time

Errors

  • 400

    Invalid window

    INVALID_RANGE
  • 401

    Not authenticated

  • 403

    Insufficient scope, or resource outside your company