List Field Operations
GET
- organization: The organization which owns this data.
- field: The field in which this operation was performed.
- self: The field operation.
OAuth Scope Required: ag2
Request URI
GET https://sandboxapi.deere.com/platform/organizations/{orgId}/fields/{fieldId}/fieldOperations
Accept: application/vnd.deere.axiom.v3+json
Parameters
Parameter | Type | Description & Example | In |
---|---|---|---|
orgId Required | string | Owning Organization ID Example: 12345 | path |
fieldId Required | GUID | Field ID Example: d01111d6-1fa4-4659-943a-3df4a6b7933c | path |
cropSeason | integer | Retrieve operations for a specific crop season (year). Example: 2016 | query |
fieldOperationType | string | Filter results by field operation type. Takes the values "APPLICATION", "HARVEST", "SEEDING", and "TILLAGE". Example: HARVEST | query |
startDate | string | Specify the starting date of the seven-day period in ISO-8601 format. Query Filter is inclusive. Example: 2018-04-25T15:18:15.205Z | query |
endDate | string | Specify the ending date of the seven-day period in ISO-8601 format. Query Filter is inclusive. Example: 2018-04-26T15:18:15.205Z | query |
embed | array | List available operation measurement types and totals. Allowed Values: measurementTypes | query |
workPlanIds | List Of GUID | Query by one or more workPlanIds(comma separated) Example: ["d6166574-4ede-404e-8a68-85d4284b869d"] | query |
x-deere-signature | string | x-deere-signature should be managed by the client per user per API. For a new user/new API, the first request will have a blank value for x-deere-signature. Changes can be tracked with the x-deere-signature returned in the response. If the response has not changed since the last API call, the value of x-deere-signature is not changed and the client should use the same String Token next time. Example: 520122365ebb4870a344784570d202c7 | header |
Headers
Key | Type | Description & Example | In / Defaults |
---|---|---|---|
Accept-UOM-System | string | Unit of measure system to use for numeric values in the shapefiles. Accepted values are "METRIC", "ENGLISH", and "MIXED".If this header is not specified, the unit system will be determined by the organization preference of the owning organization.For all unit systems, the units are consistent with ADAPT's unit system. Example: METRIC | header |
Accept-Yield-Preference | string | Desired yield representation (unit) type. Accepted values are VOLUME or MASS. Example: VOLUME | header |
Round-Measurements | boolean | Set to true for standard Deere rounded measurements. Set to false for not rounded measurements. | header |
Response Details
Field | Type | Description & Example |
---|---|---|
id | string | Field Operation ID Example: MjkyMDdfNT |
x-deere-signature | string | A new x-deere-signature response header will be included if the response has changed since last api call. Example: 520122365ebb4870a344784570d202c7 |
fieldOperationType1 | string | Field Operation type. Example: application |
cropSeason | string | Crop season year. Example: 2015 |
adaptMachineType | string | The type of machine that generated the field operation. This may be "unknown". Example: unknown |
startDate | datetime | Starting date and time of this field operation.. Example: 2015-05-29T22:00:19.200Z |
endDate | datetime | Ending date and time of this field operation. Example: 2015-05-29T22:23:53.746Z |
modifiedTime | datetime | Last time that anything was modified on this field operation. Example: 2016-04-29T22:12:53.446Z |
cropName | string | Crop Name. Example: CORN_WET |
varieties | array | List of seed varieties. Only available on harvest and seeding operation types. May contain guid, productType, name, brand, agencyRegistrationNumber, and tankMix Example: [ { "@type": "Product", "productType": "SEED", "name": "aa1", "tankMix": false } ] |
products | --- | Details of the product applied during this field operation. Includes name, tankmix, rate, carrier, and components data. Example: See sample response below. |
name | string | Name of the tank mix Example: Tank Mix Use 1 |
tankMix | boolean | Boolean flag as to whether the application operation was for a tank mix or not. Example: true |
rate | --- | Rate of the application. Includes value and unitId2 data. Example: See sample response below. |
value | number | Numeric value. Example: 10 |
unitId2 | string | Unit of value. Example: gal1ac-1 |
carrier | --- | Data on the product carrier. Includes name and rate. Example: See sample response below. |
components | --- | Data on the product component. Includes name and rate. Example: See sample response below. |
fieldOperationMachines | object | Machines utilized during this operation |
Sample Response [JSON]
Content-Type: application/vnd.deere.axiom.v3+json
x-deere-signature: 520122365ebb4870a344784570d202c7
{ "links": [ { "rel": "self", "uri": "https://sandboxapi.deere.com/platform/organizations/123456/fields/d61b83f4-3a12-431e-8010-596f2466dc27/fieldOperations" } ], "total": 2, "values": [ { "@type": "FieldOperation", "fieldOperationType": "Tillage", "adaptMachineType": "unknown", "cropSeason": "2012", "modifiedTime": "2018-05-16T15:04:24.787Z", "startDate": "2012-04-03T14:12:13.000Z", "endDate": "2012-04-06T15:53:37.408Z", "fieldOperationMachines": [ { "@type": "FieldOperationMachine", "erid": "t48a7dd0-as35-44e1-81b4-435d494f7cd5", "machineId": 637795, "operators": [ { "@type": "Operator", "operatorId": "OPERATOR_ID", "license": "OPERATOR_LICENSE", "name": "OPERATOR_NAME" } ], "vin": "WXYEJKB73894JE3" } ], "id": "MjIzMDMxXzU4NDFkMDM2YTA2ZDkwMDk3MGYyNDJkMw", "links": [ { "@type": "Link", "rel": "organization", "uri": "https://sandboxapi.deere.com/platform/organizations/123456" }, { "@type": "Link", "rel": "field", "uri": "https://sandboxapi.deere.com/platform/organizations/123456/fields/d61b83f4-3a12-431e-8010-596f2466dc27" }, { "@type": "Link", "rel": "self", "uri": "https://sandboxapi.deere.com/platform/fieldOperations/MjIzMDMxXzU4NDFkMDM2YTA2ZDkwMDk3MGYyNDJkMw" }, { "@type": "Link", "rel": "measurementTypes", "uri": "https://sandboxapi.deere.com/platform/fieldOperations/MjIzMDMxXzU4NDFkMDM2YTA2ZDkwMDk3MGYyNDJkMw/measurementTypes" }, { "@type": "Link", "rel": "client", "uri": "https://sandboxapi.deere.com/platform/organizations/123456/clients/46234f43-0000-1000-4014-e1e1e11124e0" }, { "@type": "Link", "rel": "farm", "uri": "https://sandboxapi.deere.com/platform/organizations/123456/farms/4641d448-0000-1000-4033-e1e1e11124e0" }, { "@type": "Link", "rel": "workPlans", "uri": "https://sandboxapi.deere.com/platform/organizations/123456/workPlans/2fac815e-5696-4ff6-86a0-39093b7dbf7e" } ] }, { "@type": "FieldOperation", "fieldOperationType": "application", "adaptMachineType": "unknown", "cropSeason": "2013", "modifiedTime": "2014-03-16T15:04:24.797Z", "startDate": "2013-07-03T16:36:08.000Z", "endDate": "2013-07-03T16:47:23.013Z", "products": { "@type": "Product", "name": "Tank Mix", "tankMix": true, "rate": { "@type": "EventMeasurement", "value": 12.5, "unitId": "gal1ac-1" }, "carrier": { "@type": "Component", "name": "Water", "rate": { "@type": "EventMeasurement", "value": 12.5, "unitId": "gal1ac-1" } }, "components": [ { "@type": "Component", "name": "Touchdown Total", "rate": { "@type": "EventMeasurement", "value": 48, "unitId": "floz1ac-1" } }, { "@type": "Component", "name": "FS MaxSupreme", "rate": { "@type": "EventMeasurement", "value": 32, "unitId": "floz1ac-1" } } ] }, "id": "MjIzMDMxXzU4NDFkMDM2YTA2ZDkwMDk3MGYyNDJkNg", "links": [ { "@type": "Link", "rel": "organization", "uri": "https://sandboxapi.deere.com/platform/organizations/123456" }, { "@type": "Link", "rel": "field", "uri": "https://sandboxapi.deere.com/platform/organizations/123456/fields/d61b83f4-3a12-431e-8010-596f2466dc27" }, { "@type": "Link", "rel": "self", "uri": "https://sandboxapi.deere.com/platform/fieldOperations/MjIzMDMxXzU4NDFkMDM2YTA2ZDkwMDk3MGYyNDJkNg" }, { "@type": "Link", "rel": "measurementTypes", "uri": "https://sandboxapi.deere.com/platform/fieldOperations/MjIzMDMxXzU4NDFkMDM2YTA2ZDkwMDk3MGYyNDJkNg/measurementTypes" }, { "@type": "Link", "rel": "client", "uri": "https://sandboxapi.deere.com/platform/organizations/123456/clients/46234f43-0000-1000-4014-e1e1e11124e0" }, { "@type": "Link", "rel": "farm", "uri": "https://sandboxapi.deere.com/platform/organizations/123456/farms/4641d448-0000-1000-4033-e1e1e11124e0" }, { "@type": "Link", "rel": "shapeFile", "uri": "https://sandboxapi.deere.com/platform/fieldOperations/MjIzMDMxXzU4NDFkMDM2YTA2ZDkwMDk3MGYyNDJkNg" }, { "@type": "Link", "rel": "shapeFileAsync", "uri": "https://sandboxapi.deere.com/platform/fieldOps/MjIzMDMxXzU4NDFkMDM2YTA2ZDkwMDk3MGYyNDJkNg" }, { "@type": "Link", "rel": "workPlans", "uri": "https://sandboxapi.deere.com/platform/organizations/123456/workPlans/2fac815e-5696-4ff6-86a0-39093b7dbf7e" } ] } ] }