GET
/organizations/{orgId}/managementZones
List Management Zones
GET
/organizations/{orgId}/managementZones/{zoneId}
View Management Zone
GET
/organizations/{orgId}/managementZones/{zoneId}/latestStatus
View Latest Status
GET /organizations /{orgId} /managementZones
List Management Zones
Management Zone Details resource will return a list of Management Zones, with details, within a current Organizations. For each Management Zone, the response will include links to the following resources:
  • latestStatus: View the latest status from this Management Zone.
  • latestSoilMoistureMeasurements: The latest soil moisture level recorded for this Management Zone.
  • soilMoistureMeasurements: List soil moisture measurements for this Management Zone.
  • latestWeatherSensorMeasurements: View the latest weather sensor measurement for this Management Zone.
  • weatherSensorMeasurements: View weather sensor measurements for this Management Zone.
  • calculatedMeasurements: View calculated measurements for this Management Zone.
  • notes: View notes for this Management Zone.
 
Request URI
GET https://sandboxapi.deere.com/fc/organizations/{orgId}/managementZones
Accept: application/vnd.deere.axiom.v3+json
 
Parameters
Parameter Type Example Description In Required?
orgId string 1234 Organization ID path Yes
filter string all By default, this resource returns only current lands. When filtered by "all," both archived and un-archived lands will be returned. query No
 
Response Details
Field Type Example Description
id string 1026e6d3-4k23-58eg-73ec-j3885h4b8lk3 Management Zone ID
name string New Gateway-MZ Management Zone Name
fieldname string New Gateway-Probe API QA Field that contains the Management Zone.
soilType1 string SandyLoam Soil type of this Management Zone.
waterManagementMethod2,4 string Flood or furrow Water management method in this Management Zone.
cropEmergenceDate4 datetime 2015-05-09T05:00:00.000Z Date that crops emerged in this Management Zone.
estimatedEmergenceDate4 datetime 2015-05-09T05:00:00.000Z Date that crops are estimated to emerge in this Management Zone.
location --- --- Includes coordinates of the Management Zone.
cropType3,4 string Barley The type of crop in this Management Zone.
Note: A Probe-to-Management Zone association in John Deere Field Connect is required to return the location of a given management zone.
 
Sample Response [JSON]
200 OK

{
   "links": [
      {
         "rel": "self",
         "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones"
      }
   ],
   "total": 2,
   "values": [
      {
         "name": "Pemberley",
         "fieldName": "Austenland",
         "soilType": "Sandy Loam",
         "location": {
            "point": {
               "lat": 41.44204,
               "lon": -90.503136
            }
         },
         "links": [
            {
               "rel": "self",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/1026e6d3-4k23-58eg-73ec-j3885h4b8lk3"
            },
            {
               "rel": "latestStatus",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/1026e6d3-4k23-58eg-73ec-j3885h4b8lk3/latestStatus"
            },
            {
               "rel": "latestSoilMoistureMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/1026e6d3-4k23-58eg-73ec-j3885h4b8lk3/latestSoilMoistureMeasurements"
            },
            {
               "rel": "soilMoistureMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/1026e6d3-4k23-58eg-73ec-j3885h4b8lk3/soilMoistureMeasurements"
            },
            {
               "rel": "latestWeatherSensorMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/1026e6d3-4k23-58eg-73ec-j3885h4b8lk3/latestWeatherSensorMeasurements"
            },
            {
               "rel": "weatherSensorMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/1026e6d3-4k23-58eg-73ec-j3885h4b8lk3/weatherSensorMeasurements"
            },
            {
               "rel": "calculatedMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/1026e6d3-4k23-58eg-73ec-j3885h4b8lk3/calculatedMeasurements"
            },
            {
               "rel": "notes",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/1026e6d3-4k23-58eg-73ec-j3885h4b8lk3/notes"
            }
         ],
         "id": "1026e6d3-4k23-58eg-73ec-j3885h4b8lk34"
      },
      {
         "name": "Northanger Abbey",
         "fieldName": "Austenland",
         "soilType": "Fine Sand",
         "links": [
            {
               "rel": "self",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5"
            },
            {
               "rel": "latestStatus",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/latestStatus"
            },
            {
               "rel": "latestSoilMoistureMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/latestSoilMoistureMeasurements"
            },
            {
               "rel": "soilMoistureMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/soilMoistureMeasurements"
            },
            {
               "rel": "latestWeatherSensorMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/latestWeatherSensorMeasurements"
            },
            {
               "rel": "weatherSensorMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/weatherSensorMeasurements"
            },
            {
               "rel": "calculatedMeasurements",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/calculatedMeasurements"
            },
            {
               "rel": "notes",
               "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/notes"
            }
         ],
         "id": "0383d5b3-2k69-57bk-83ck-l2957d8s8si5"
      }
   ]
}
 
GET /organizations /{orgId}/managementZones /{zoneId}
View a Management Zone.
This resource will return details about the specified Management Zone. The response will include links to the following resources:
  • latestStatus: View the latest status from this Management Zone.
  • latestSoilMoistureMeasurements: The latest soil moisture level recorded for this Management Zone.
  • soilMoistureMeasurements: List soil moisture measurements for this Management Zone.
  • latestWeatherSensorMeasurements: View the latest weather sensor measurement for this Management Zone.
  • weatherSensorMeasurements: View weather sensor measurements for this Management Zone.
  • calculatedMeasurements: View calculated measurements for this Management Zone.
  • notes: View notes for this Management Zone.
 
Request URI
GET https://sandboxapi.deere.com/fc/organizations/{orgId}/managementZones/{zoneId}
Accept: application/vnd.deere.axiom.v3+json
 
Parameters
Parameter Type Example Description In Required?
orgId string 1234 Organization ID path Yes
managementZoneId string 1026e6d3-4k23-58eg-73ec-j3885h4b8lk3 Management Zone ID path Yes
 
Response Details
Field Type Example Description
id string 8a41b7ca-09b1-4c61-acd1-b8e933f8f22f Management Zone ID
name string Zone Two Management Zone Name
fieldname string New Gateway-Probe API QA Field that contains the Management Zone.
soilType1 string Clay Loam Soil type of this Management Zone.
waterManagementMethod2,4 string Flood or furrow Water management method in this Management Zone.
cropEmergenceDate4 datetime 2015-05-09T05:00:00.000Z Date that crops emerged in this Management Zone.
estimatedEmergenceDate4 datetime 2015-11-01T04:59:00.000Z Estimated date that crops will emerge in this Management Zone.
location --- --- Includes coordinates of the Management Zone. This data is only returned if "location" was embedded in the request.
cropType3,4 string Barley The type of crop in this Management Zone.
Note: A Probe-to-Management Zone association in John Deere Field Connect is required to return the location of a given management zone.
 
Sample Response [JSON]
200 OK

{
   "name": "Northanger Abbey",
   "fieldName": "Austenland",
   "soilType": "Fine Sand",
   "links": [
      {
         "rel": "self",
         "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5"
      },
      {
         "rel": "latestStatus",
         "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/latestStatus"
      },
      {
         "rel": "latestSoilMoistureMeasurements",
         "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/latestSoilMoistureMeasurements"
      },
      {
         "rel": "soilMoistureMeasurements",
         "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/soilMoistureMeasurements"
      },
      {
         "rel": "latestWeatherSensorMeasurements",
         "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/latestWeatherSensorMeasurements"
      },
      {
         "rel": "weatherSensorMeasurements",
         "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/weatherSensorMeasurements"
      },
      {
         "rel": "calculatedMeasurements",
         "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/calculatedMeasurements"
      },
      {
         "rel": "notes",
         "uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/notes"
      }
   ],
   "id": "0383d5b3-2k69-57bk-83ck-l2957d8s8si5"
}
 
GET /organizations/{orgId} /managementZones/{zoneId} /latestStatus
View Latest Status
This resource will return the last reported status for the specified Management Zone.
 
Request URI
GET https://sandboxapi.deere.com/fc/organizations/{orgId}/managementZones/{zoneId}/latestStatus
Accept: application/vnd.deere.axiom.v3+json
 
Parameters
Parameter Type Example Description In Required?
orgId string 1234 Organization ID path Yes
managementZoneId string 1026e6d3-4k23-58eg-73ec-j3885h4b8lk3 Management Zone ID path Yes
 
Response Details
Field Type Example Description
probeSerialNumber string PCPB05A100001 Probe serial number.
status5 string Refill Point Warning Management Zone Status
lastMeasurementTime datetime 2015-08-14T11:58:00.000Z The last time this status was reported.
 
Sample Response [JSON]
200 OK

{
"probeSerialNumber": PCDC15G215648",
"status": "FULL_POINT",
"lastMeasurementTime": "2015-08-14T11:58:00.000Z",
"links": [
{
"rel": "self",
"uri": "https://sandboxapi.deere.com/fc/organizations/1234/managementZones/0383d5b3-2k69-57bk-83ck-l2957d8s8si5/latestStatus"
}
]
}
 
[1] Soil Types: Coarse Sand; Fine Sand; Loam; Clay Loam; Non Swelling Clay; Swelling Clay
[2] Water Management Methods: Center Pivot; Dry Land Operations; Flood or Furrow; Lateral Move; Localized; Sprinkler; Sub-irrigation
[3] Crop Type: Barley; Canola; Corn; Cotton; Flaxseed; Hay; Hops; Lentils; Millet; Mint; Mustard; Oats; Rice; Rye; Sorghum; Soybeans; Sugarbeets; Sugarcane; Sunflower; Wheat; Almonds; Apples; Apricots; Blackberries; Blueberries; Boysenberries; Cherries; Cranberries; Dates; Figs; Grapefruit; Grapes; Hazelnuts; Lemons; Limes; Macadamias; Nectarines; Olives; Oranges; Peaches; Pears; Pecans; Pistachios; Plums; Prunes; Raspberries; Strawberries; Tangerines; Walnuts; Artichokes; Asparagus; Beans; Broccoli; Brussel Sprouts; Cabbage Carrots; Cauliflower; Celery; Cucumbers; Eggplant; Garlic; Ginger Root; Lettuce; Melons; Onions; Peas; Peppers; Pickles; Potatoes; Pumpkins; Radishes; Spinach; Squash; Sweet Corn; Sweet Potatoes; Tomatoes
[4] This data will only be returned if it is available.
[5] Management Zone Statuses: Active; Full Point; Full Point Warning; Refill Point; Refill Point Warning; Inactive; Active-No Budget; Active-No Data