GET
/source/{sourceId}/client/{clientId}/farm/{farmId}/field
List Fields
GET
/source/{sourceId}/client/{clientId}/farm/{farmId}/field/{fieldId}
View a Field
POST
/source/{id}/client/{id}/farm/{id}/field/{id}
Create/Update Field
POST
/source/{id}/client/{id}/farm/{id}/field/{id}
Delete Field
Field Definitions
GET /source/{sourceId}/client/{clientId} /farm/{farmId}/ /field
List Fields
 
Request URI
GET https://api.soa-proxy.deere.com/aglogic/source/{sourceId}/client/{clientId}/farm/{id}/field/
Accept: */*
 
Request Parameters
This resource does not currently take any filters/request parameters.
 
Response Details
Field Type Example Description
field --- See sample response below. Field information.
id string 1 Field ID.
name string Krueger Farm Field Name
 
Sample Response in XML
<?xml version="1.0" encoding="UTF-8"?>
<fields xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
  <link>
    <rel>self</rel>
    <uri>https://apicert.soa-proxy.deere.com/aglogic/source/x/client/0000000008/farm/Krueger/field</uri>
  </link>
  <field>
    <id>1</id>
    <name>Krueger Farm</name>
    <link>
      <rel>field</rel>
      <uri>https://apicert.soa-proxy.deere.com/aglogic/source/x/client/0000000008/farm/Krueger/field/1</uri>
    </link>
  </field>
</fields>
 
GET /source/{sourceId}/client/{clientId} /farm/{farmId}/field/{fieldId}/
View a Field
 
Request URI
GET https://api.soa-proxy.deere.com/aglogic/source/{sourceId}/client/{clientId}/farm/{id}/field/{fieldId}
Accept: */*
 
Request Parameters
This resource does not currently take any filters/request parameters.
 
Response Details
Field Type Example Description
id string ne-1-9-30 Field ID.
name string ne-1-9-30 Field Name
acres num 3.0 Acres of property.
street1 string 3 Main St. Street address line 1.
street1 string Apt 100 Street address line 2.
city string Maycomb City.
state string AL State.
zip string 30012 Zip code.
email string atticus.finch@finchlaw.com Email address.
phone string 123.456.7890 Phone number.
entry-point --- See sample request below. Includes the coordinates of the entry point of this client's farm.
client --- See sample request below. Client owning this farm. Includes name and ID.
farm --- See sample request below. Farm owning this field Includes name and ID.
boundary --- See sample request below. Boundary of this field.
 
Sample Response in XML
<?xml version="1.0" encoding="UTF-8"?>
<fields xmlns="http://api.deere.com/v3">   <link>
    <rel>self</rel>
    <uri>https://apicert.soa-proxy.deere.com/nulog/v1/source/x/client/1820680321/farm/Michael/field/ne-1-9-30</uri>
  </link>
  <id>ne-1-9-30</id>
  <name>ne-1-9-30</name>
  <acres>2.0</acres>
  <street1>3 Main Street</street1>
  <street2 />
  <city>Maycomb</city>
  <state>AL</state>
  <zip>30022</zip>
  <email>atticus.finch@finchlaw.com</email>
  <phone>123.456.7890</phone>
  <entry-point>
    <coordinates>-88.39640544530845,41.84997836539172</coordinates>
  </entry-point>
  <client>
    <id>1820680321</id>
    <name>388053996</name>
    <link>
      <rel>client</rel>
      <uri>https://apicert.soa-proxy.deere.com/nulog/v1/client/1820680321</uri>
    </link>
  </client>
  <farm>
    <id>Michael</id>
    <name>Michael</name>
    <link>
      <rel>field</rel>
      <uri>https://apicert.soa-proxy.deere.com/nulog/v1/source/x/client/1820680321/farm/Michael</uri>
    </link>
  </farm>
  <boundary>
    <Polygon>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>-89.4041702265531,43.075756410903544 -89.38983650223236,43.06911036569286 -89.395844650262,43.06729198248163 -89.3900081634456,43.07550562982983 -89.37936515758338,43.07594449603532 -89.38254089305701,43.081273334871426</coordinates>
        </LinearRing>
      </outerBoundaryIs>
    </Polygon>
  </boundary>
</fields>
 
POST /source/{id}/client/{id} /farm/{id}/field/{id}/
Create/Update Field
 
Request URI
POST https://api.soa-proxy.deere.com/aglogic/source/{sourceId}/client/{clientId}/farm/{id}/field/{id}/
Accept: */*
 
Request Parameters
This resource does not currently take any filters/request parameters.
 
Request Details
Field Type Example Description
name string Finch Farms Field Name
acres integer 3 Number of acres in this field.
street1 string 3 Main Street Street address
city string Maycomb City name.
state string AL State name.
zip string 30022 Zip code.
email string atticus.finch@finchlaw.com Email address.
phone string 123.456.7890 Phone number.
entry-point --- See sample request below. Includes the coordinates of the entry point of this field.
boundary --- See sample request below. Boundary of this field.
 
Sample Request in XML
https://api.soa-proxy.deere.com/aglogic/source/223031/client/1/farm/1/field/1

<?xml version="1.0" encoding="UTF-8"?>
<field xmlns="http://www.deere.com/agriservices/schemas/nutrientlogistics/ backofficeintegration"
xmlns:kml="http://earth.google.com/kml/2.1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <name>Finch Farms</name>
  <acres>3</acres>
  <street1>3 Main Street</street1>
  <city>Maycomb</city>
  <state>AL</state>
  <zip>30022</zip>
  <email>atticus.finch@finchlaw.com</email>
  <phone>123.456.7890</phone>
  <entry-point>
    <kml:coordinates>-84.1, 33.1</kml:coordinates>
  </entry-point>
  <boundary />
</field>
 
Response Codes
Codes  
200 Success.
400 Bad Request. Check that the passed data is in the right format and passes schema validation.
401 Unauthorized. There is a problem with the credentials provided.
404 Problem with the URL. Check that the URL matches the pattern described above.
500 Server error. An unexpected error occurred on the server processing your post.
POST /source/{id}/client/{id}/farm/{id}/field/{id}
Delete Field
 
Request URI
POST https://api.soa-proxy.deere.com/aglogic/source/{sourceId}/client/{clientId}/farm/{id}/field/{id}?_method=delete
or, if fields are directly associated with clients,
POST https://api.soa-proxy.deere.com/aglogic/source/{sourceId}/client/{clientId}/field/{id}?_method=delete
Accept: */*
 
HTTP Method
POST
Note: You would expect that we would use HTTP DELETE here. However, many web hosting environments, including John Deere’s, do not allow HTTP DELETES. Because of this we have to “tunnel” our Delete request using the URL.
 
Request Parameters
This resource does not currently take any filters/request parameters.
 
Request Details
Field Type Example Description
name string Finch Farms Field Name
acres integer 3 Number of acres in this field.
street1 string 3 Main Street Street address
city string Maycomb City name.
state string AL State name.
zip string 30022 Zip code.
email string atticus.finch@finchlaw.com Email address.
phone string 123.456.7890 Phone number.
entry-point --- See sample request below. Includes the coordinates of the entry point of this field.
boundary --- See sample request below. Boundary of this field.
 
Sample Request in XML
https://api.soa-proxy.deere.com/aglogic/source/223031/client/1/farm/1/field/1

<?xml version="1.0" encoding="UTF-8"?>
<field xmlns="http://www.deere.com/agriservices/schemas/nutrientlogistics/ backofficeintegration"
xmlns:kml="http://earth.google.com/kml/2.1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <name>Finch Farms</name>
  <acres>3</acres>
  <street1>3 Main Street</street1>
  <city>Maycomb</city>
  <state>AL</state>
  <zip>30022</zip>
  <email>atticus.finch@finchlaw.com</email>
  <phone>123.456.7890</phone>
  <entry-point>
    <kml:coordinates>-84.1, 33.1</kml:coordinates>
  </entry-point>
  <boundary />
</field>
 
Response Codes
Codes  
200 Success.
400 Bad Request. It is likely that the field specified cannot be deleted. The field may have assigned or open orders associated with it.
401 Unauthorized. There is a problem with the credentials provided.
404 Problem with the URL. Check that the URL matches the pattern described above.
500 Server error. An unexpected error occurred on the server processing your post.
Field Definitions  
Field
A field is a subdivision of the farm/client. It is the smallest geographical entity that AgLogic deals with.
 
   
id BMS identifier for the Farm. The combination of client id, farm id, and field id must be unique within an organization in AgLogic.
name Field name.
farm id BMS identifier for the farm that this field is associated with.
client id BMS identifier for the client that this field is associated with.
acres Number of acres covered by this field.
street1 Address field one for this field.
street2 Address field two for this field.
city The city where this field is located.
state The state where this farm is located.
zip Zip code of this field.
email Email address for this field's contact.
phone Phone number of this field's contact.
entry point(s) Lat/Lon pair(s) identifying the field entry point.
field boundary Collection of data describing the boundaries of the field.