POST v2/irrigation-recommendations.{ext}

Single call Web API which returns multiple recommendations

Request Information

URI Parameters

None.

Body Parameters

SingleCallIrrigationRecommendationsModel

Name	Description	Type	Additional information
DistributionUniformities	A list of distribution uniformities associated with a planting. We recommend that you specify this value. The list will fallback to default values if not specified. The value for uniformity should be between 0 and 100.	Collection of DistributionUniformity	None.
CropTypeId	Crop type ID. WARNING: ID between production and development environments can be different.	integer	None.
WetDate	Planting wet date	date	None.
HarvestDate	Planting harvest date	date	None.
WeatherStationId	Weather station ID. For now, only one weather station is allowed. WARNING: ID between production and development environments can be different.	integer	None.
IrrigationEvents	A list of past irrigation events. Future irrigation events will not impact recommendations. Past irrigation events will be used to calculate recommendations. The applied amounts specified in the past irrigation events will be used to calculate soil evaporation	Collection of SingleCallIrrigationEventModel	None.
SoilProperties	Soil data, used to calculate soil evaporation.	SingleCallSoilTypeModel	None.
CutEvents	a List of dates for cut events (optional), which is used for alfalfa	Collection of date	None.
LeechingRequirement	Leeching requirement. It will fallback to a default value (0) if not specified. The value should be between 0 and 100.	decimal number	None.
AgeOfCrop	Age of crop for perennial crop types (optional), like almonds and alfafa, specified in years, ranging between 0 and 14.	integer	None.
CropSensitivity	Defaults to 1, or 100%. The value can be reduced to lower irrigation recommendation. The value should be between 0 and 1.	decimal number	None.
MacroTunnelStart	Macro tunnel start date (optional) If a macro tunnel feature is available for a crop, this date will be used to specify the date when macro tunnel is applied. On dates when macro tunnel is active, rainfall is ignored, and ET is reduced.	date	None.
MacroTunnelEnd	Macro tunnel end date (optional) If a macro tunnel feature is available for a crop, this date will be used to specify the date when macro tunnel is removed.	date	None.
Stress	Stress properties (optional), used by tree crops and processing tomato	SingleCallStress	None.
Latitude	Only used for the seasonal ET calculator. When set, soil data is automatically detected	decimal number	None.
Longitude	Only used for the seasonal ET calculator.	decimal number	None.

Request Formats

application/json, text/json, text/html

Sample:

{
  "DistributionUniformities": [
    {
      "IrrigationMethodId": 1,
      "Uniformity": 2.0
    },
    {
      "IrrigationMethodId": 1,
      "Uniformity": 2.0
    }
  ],
  "CropTypeId": 1,
  "WetDate": "2025-05-23T13:54:12.7640628-07:00",
  "HarvestDate": "2025-05-23T13:54:12.7640628-07:00",
  "WeatherStationId": 4,
  "IrrigationEvents": [
    {
      "EventDate": "2025-05-23T13:54:12.7640628-07:00",
      "MethodId": 2,
      "Applied": 3.0
    },
    {
      "EventDate": "2025-05-23T13:54:12.7640628-07:00",
      "MethodId": 2,
      "Applied": 3.0
    }
  ],
  "SoilProperties": {
    "Sand": 1.0,
    "Silt": 2.0
  },
  "CutEvents": [
    "2025-05-23T13:54:12.7640628-07:00",
    "2025-05-23T13:54:12.7640628-07:00"
  ],
  "LeechingRequirement": 1.0,
  "AgeOfCrop": 1,
  "CropSensitivity": 1.0,
  "MacroTunnelStart": "2025-05-23T13:54:12.7640628-07:00",
  "MacroTunnelEnd": "2025-05-23T13:54:12.7640628-07:00",
  "Stress": {
    "StartLevel": 1,
    "EndLevel": 2,
    "StartDate": "2025-05-23T13:54:12.7640628-07:00",
    "EndDate": "2025-05-23T13:54:12.7640628-07:00"
  },
  "Latitude": 1.0,
  "Longitude": 1.0
}

application/xml, text/xml

Sample:

<SingleCallIrrigationRecommendationsModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <CropTypeId>1</CropTypeId>
  <WetDate>2025-05-23T13:54:12.7640628-07:00</WetDate>
  <HarvestDate>2025-05-23T13:54:12.7640628-07:00</HarvestDate>
  <WeatherStationId>4</WeatherStationId>
  <IrrigationEvents>
    <SingleCallIrrigationEventModel>
      <EventDate>2025-05-23T13:54:12.7640628-07:00</EventDate>
      <MethodId>2</MethodId>
      <Applied>3</Applied>
    </SingleCallIrrigationEventModel>
    <SingleCallIrrigationEventModel>
      <EventDate>2025-05-23T13:54:12.7640628-07:00</EventDate>
      <MethodId>2</MethodId>
      <Applied>3</Applied>
    </SingleCallIrrigationEventModel>
  </IrrigationEvents>
  <SoilProperties>
    <Sand>1</Sand>
    <Silt>2</Silt>
  </SoilProperties>
  <CutEvents>
    <dateTime>2025-05-23T13:54:12.7640628-07:00</dateTime>
    <dateTime>2025-05-23T13:54:12.7640628-07:00</dateTime>
  </CutEvents>
  <LeechingRequirement>1</LeechingRequirement>
  <AgeOfCrop>1</AgeOfCrop>
  <CropSensitivity>1</CropSensitivity>
  <MacroTunnelStart>2025-05-23T13:54:12.7640628-07:00</MacroTunnelStart>
  <MacroTunnelEnd>2025-05-23T13:54:12.7640628-07:00</MacroTunnelEnd>
  <Stress>
    <StartLevel>1</StartLevel>
    <EndLevel>2</EndLevel>
    <StartDate>2025-05-23T13:54:12.7640628-07:00</StartDate>
    <EndDate>2025-05-23T13:54:12.7640628-07:00</EndDate>
  </Stress>
  <Latitude>1</Latitude>
  <Longitude>1</Longitude>
  <DistributionUniformities>
    <DistributionUniformity>
      <IrrigationMethodId>1</IrrigationMethodId>
      <Uniformity>2</Uniformity>
    </DistributionUniformity>
    <DistributionUniformity>
      <IrrigationMethodId>1</IrrigationMethodId>
      <Uniformity>2</Uniformity>
    </DistributionUniformity>
  </DistributionUniformities>
</SingleCallIrrigationRecommendationsModel>

Response Information

Resource Description

Collection of IrrigationRecommendationSimpleModel

Name	Type	Additional information
EventDate	date	None.
RecommendedIrrigationAmount	decimal number	None.
AvailableWater	decimal number	None.
AverageCropET	decimal number	None.
AverageRainfall	decimal number	None.
SumET	decimal number	None.
CropCoefficientSum	decimal number	None.
LeechingFactor	decimal number	None.
Distribution	decimal number	None.
TotalPrecipitation	decimal number	None.
CIMISRainfall	string	None.
DaysSinceLastIrrigation	decimal number	None.
BaseIrrigationAmount	decimal number	None.
AverageCropCoefficient	decimal number	None.
LastIrrigationEventDate	date	None.
CropSensitivity	decimal number	None.

Response Formats

application/json, text/json, text/html

Sample:

Sample not available.