POST v2/irrigation-recommendation.{ext}

Single call Web API endpoint for irrigation recommendations. This Web API call can be used to request irrigation recommendations from CropManage, without having to first set up ranches or plantings.

Request Information

URI Parameters

None.

Body Parameters

SingleCallIrrigationRecommendationModel

Name	Description	Type	Additional information
EventDate	Target event date	date	None.
DistributionUniformity	Distribution uniformity. We recommend that you specify this value. It will fallback to a default value for drip irrigation (85) if not specified. The value for this field should be between 0 and 100.	decimal number	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:

{
  "EventDate": "2025-04-18T10:13:15.9234571-07:00",
  "DistributionUniformity": 1.0,
  "CropTypeId": 2,
  "WetDate": "2025-04-18T10:13:15.9234571-07:00",
  "HarvestDate": "2025-04-18T10:13:15.9234571-07:00",
  "WeatherStationId": 5,
  "IrrigationEvents": [
    {
      "EventDate": "2025-04-18T10:13:15.9234571-07:00",
      "MethodId": 2,
      "Applied": 3.0
    },
    {
      "EventDate": "2025-04-18T10:13:15.9234571-07:00",
      "MethodId": 2,
      "Applied": 3.0
    }
  ],
  "SoilProperties": {
    "Sand": 1.0,
    "Silt": 2.0
  },
  "CutEvents": [
    "2025-04-18T10:13:15.9234571-07:00",
    "2025-04-18T10:13:15.9234571-07:00"
  ],
  "LeechingRequirement": 1.0,
  "AgeOfCrop": 1,
  "CropSensitivity": 1.0,
  "MacroTunnelStart": "2025-04-18T10:13:15.9234571-07:00",
  "MacroTunnelEnd": "2025-04-18T10:13:15.9234571-07:00",
  "Stress": {
    "StartLevel": 1,
    "EndLevel": 2,
    "StartDate": "2025-04-18T10:13:15.9234571-07:00",
    "EndDate": "2025-04-18T10:13:15.9234571-07:00"
  },
  "Latitude": 1.0,
  "Longitude": 1.0
}

application/xml, text/xml

Sample:

<SingleCallIrrigationRecommendationModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <CropTypeId>2</CropTypeId>
  <WetDate>2025-04-18T10:13:15.9234571-07:00</WetDate>
  <HarvestDate>2025-04-18T10:13:15.9234571-07:00</HarvestDate>
  <WeatherStationId>5</WeatherStationId>
  <IrrigationEvents>
    <SingleCallIrrigationEventModel>
      <EventDate>2025-04-18T10:13:15.9234571-07:00</EventDate>
      <MethodId>2</MethodId>
      <Applied>3</Applied>
    </SingleCallIrrigationEventModel>
    <SingleCallIrrigationEventModel>
      <EventDate>2025-04-18T10:13:15.9234571-07:00</EventDate>
      <MethodId>2</MethodId>
      <Applied>3</Applied>
    </SingleCallIrrigationEventModel>
  </IrrigationEvents>
  <SoilProperties>
    <Sand>1</Sand>
    <Silt>2</Silt>
  </SoilProperties>
  <CutEvents>
    <dateTime>2025-04-18T10:13:15.9234571-07:00</dateTime>
    <dateTime>2025-04-18T10:13:15.9234571-07:00</dateTime>
  </CutEvents>
  <LeechingRequirement>1</LeechingRequirement>
  <AgeOfCrop>1</AgeOfCrop>
  <CropSensitivity>1</CropSensitivity>
  <MacroTunnelStart>2025-04-18T10:13:15.9234571-07:00</MacroTunnelStart>
  <MacroTunnelEnd>2025-04-18T10:13:15.9234571-07:00</MacroTunnelEnd>
  <Stress>
    <StartLevel>1</StartLevel>
    <EndLevel>2</EndLevel>
    <StartDate>2025-04-18T10:13:15.9234571-07:00</StartDate>
    <EndDate>2025-04-18T10:13:15.9234571-07:00</EndDate>
  </Stress>
  <Latitude>1</Latitude>
  <Longitude>1</Longitude>
  <EventDate>2025-04-18T10:13:15.9234571-07:00</EventDate>
  <DistributionUniformity>1</DistributionUniformity>
</SingleCallIrrigationRecommendationModel>

Response Information

Resource Description

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.