Version 5 Fieldprint API Input Reference
Documentation Notice
This documentation reflects the Fieldprint Platform API v5.0.2 as of April 2026. The Fieldprint Platform is actively developed and implementation details may evolve between releases. While we work to keep this reference accurate, we encourage API partners to validate behavior against the live API and reference data endpoints. The Field to Market team is available to support your integration — contact support@fieldtomarket.org or your partner liaison with any questions.
Complete reference for all input parameters to the /v5/Calculator endpoint — organized by section, filterable by data source, requirement level, and sustainability indicator.
The Fieldprint Platform Calculator accepts a rich set of inputs that describe a field’s physical characteristics, multi-year crop rotation, and detailed management activities. These inputs come from three sources: data the farmer provides about their operations, data the platform derives automatically from geospatial databases and smart defaults, and configuration options the API partner controls. Understanding which inputs come from where — and which are required — is key to building a successful integration.
Access to the Fieldprint Platform and API requires Field to Market membership and an active Data Management Licensing Agreement. Learn more about membership and our data partner program to get started. Access to the Fieldprint API requires an authorized API key issued by Field to Market.
See also: Conditional Logic & Decision Guide — documents the if/then branching patterns that determine which fields are required based on your selections (activity types, crop, fertilizer category, etc.).
Farmer Provided by the farmer or grower
Platform Derived or prefilled by the platform
API Partner Controlled by the QDMP partner
Required Always required
Conditional Required under certain conditions
Optional Has a default or is not required
123 input parameters — click a section to expand
Crop-specific inputs tagged: Crop
| Parameter | Type | Source / Req. | Description |
|---|---|---|---|
| API Options | |||
| API Switches 4 | |||
validate_only
validate_only
|
Boolean | API PartnerOptional |
Top-level flag. When true, the API runs input validation only — no metrics are computed, no models are run, and no report is generated. Returns {"result": "OK"} if the payload passes, or specific error details identifying the first validation failure encountered. Useful for quickly checking payload structure and values before submitting a full calculation.
Default: False
|
skip_models
options.skip_models
|
Boolean | API PartnerOptional |
Skips running the environmental models (WEPP, WEPS, and SWAT+) but still computes all other metrics. Soil Conservation and Soil Carbon indicators will return zero values, while Energy Use, GHG Emissions, Land Use, Irrigation Water Use, Water Quality, and Biodiversity return real results. The response metadata shows "Skipped" for bypassed model versions. Useful for testing payloads and debugging without the overhead of full model runs.
Default: False
|
retry
N/A
|
Boolean | API PartnerOptional | Boolean flag to ignore the API cache (and force a new computation) when retrying identical requests. By default (false), the cached API response will be re-used unless there was an error. Note that successful CSU model results are cached separately and might be reused regardless of this flag. Default: False |
qdmp_request_id
options.qdmp_request_id
|
String | API PartnerOptional | Optional value to pass into request. This can be used as a unique identifier for qdmp's that will be passed back in the response for tracking purposes. It is not used by the api for anything. |
| Report Generation Options 7 | |||
generate
options.report.generate
|
Boolean | API PartnerConditional |
This is a flag that tells the endpoint whether to generate the a link to a printable PDF report. The default is false.
Default: False
Required to run report
|
field_name
field.field_name
|
String | FarmerConditional |
Field Name
Required to run report
|
generated_for
options.report.generated_for
|
String | API PartnerConditional |
This is a text field that can be added to the PDF report by information supplied by the QDMP. This is typically used to display the organization that collected the data on the top portion of the report. Report space is limited to 40 characters including spaces.
Required to run report
|
grower
options.report.grower
|
String | API PartnerConditional |
This is a text field that can be added to the PDF report by information supplied by the QDMP. This is typically used to display a grower name or id on the top portion of the report. Report space is limited to 40 characters including spaces.
Required to run report
|
location
field.location
|
String | FarmerOptional |
This is a text field that can be added to the PDF report by information supplied by the QDMP. This is typically used to display a location for the field, such as County and State on the top portion of the report. If not included the location will default to the state. Report space is limited to 40 characters including spaces.
Recommended to run report
|
project_name
options.project_name
|
String | API PartnerOptional |
This is a text field that can be added to the PDF report by information supplied by the QDMP to help keep track of projects. If no value is provided, Not Specified will be returned. Report space is limited to 40 characters including spaces.
Optional for report
|
data_status
options.data_status
|
String | API PartnerOptional |
Controls the Data Status line on the report header. To display a project name, prefix the value with Project: (e.g. "Project: ACME Corn/Soybean"). Without the prefix, the value is shown as the Data Status.
Optional for report
|
| Field Definition | |||
| Field Boundary & Location 2 | |||
geometry
field.geometry
|
Object | FarmerRequired |
Draw Field Boundary
Always required
Validation: Calculated size from the geometry can not exceed 9,999 acres or be smaller than 0.5 acres
|
plantable_acres acres
field.plantable_acres
|
Object | PlatformConditional |
Plantable Acres
Default: Derived from geometry
Required. Override if plantable acres is not the same as the field size. This will default to the the size of the field boundary if they do not provide a value.
Validation: "+/- 10%" of calculated field boundary acres
|
| Soil Characteristics 4 | |||
slope %
field.soil_inputs.slope
|
Object | PlatformOptional |
Field Slope
Default: Derived from SSURGO
Not required. Override if the SSURGO result does not match the value for the field.
Validation: Set min / max to NRCS IET valid range of 0.001 to 100%
|
slope_length feet
field.soil_inputs.slope_length
|
Object | PlatformOptional |
Slope length of field
Default: Derived from SSURGO
Not required. Override if the SSURGO result does not match the value for the field.
Validation: Min value: 5, Max value: 2600
|
texture_id
field.soil_inputs.texture_id
|
String | PlatformOptional |
Physical description of the soil
Default: Derived from SSURGO
Not required. Override if the SSURGO result does not match the value for the field.
|
clay %
field.soil_inputs.clay
|
Object | PlatformOptional |
Percentage of soil that is clay
Default: Derived from SSURGO
Not required. Override if the SSURGO result does not match the value for the field.
|
| Field Details | |||
| Conservation Practices 3 | |||
practice_id
field.field_detail_inputs.practices[].practice_id
|
String | FarmerConditional |
Specific practice from drop down
Required for all items in the practices array. Leave array empty if no practices.
|
year_installed
intentionally blank for now
|
String | FarmerConditional |
Drop down menu to select year
Currently not used; may be required in future for all items in the practices array
|
year_removed
intentionally blank for now
|
String | FarmerConditional |
Drop down menu to select year
Currently not used; may be required in future for all items in the practices array
Validation: Removed year shouldn't be before installed date
|
| Land-Use Change 6 | |||
has_landuse_change
field.field_detail_inputs.landuse_change.has_landuse_change
|
Boolean | PlatformConditional |
Toggle to select yes or no for each practice type
Default: False
Not currently required (defaults to false)
|
change_year
field.field_detail_inputs.landuse_change.change_year
|
String | FarmerConditional |
Drop down menu to select year
Required if land use change is marked as 'Yes'
|
land_conversion_type_id
field.field_detail_inputs.landuse_change.land_conversion_type_id
|
String | FarmerConditional |
Drop down menu to choose previous land use: grassland, forest, shrubland
Required if land use change is marked as 'Yes'
|
land_conversion_acres acres
field.field_detail_inputs.landuse_change.land_conversion_acres
|
Object | FarmerConditional |
Input a number for the amount of acres converted
Required if land use change is marked as 'Yes'
Validation: Shouldn't be greater than the field size
|
dominant_genus_id
field.field_detail_inputs.landuse_change.dominant_genus_id
|
String | FarmerConditional |
If forest is selected, presents drop down menu for dominant genus identifications: Pinus sp.; Eucalyptus sp.; Tectona sp.; Other broadleaves
Required if land use change is marked as 'Yes' and land conversion type is forest
|
grassland_management_id
field.field_detail_inputs.landuse_change.grassland_management_id
|
String | FarmerConditional |
If grassland is selected, presents drop down menu to select method of management in varying degrees of improvement
Required if land use change is marked as 'Yes' and land conversion type is grasslands
|
| Tile Drainage 3 | |||
tile_density_id
field.field_detail_inputs.tile_drainage.tile_density_id
|
String | FarmerConditional |
Bullet option to select Standard Density or High Density
Required. Set to 1 if no drainage system.
|
year_installed
intentionally blank for now
|
String | FarmerConditional |
Drop down menu to select year
Not currently used; may be required in future if tile_density_id is not 0
|
year_removed
intentionally blank for now
|
String | FarmerConditional |
Drop down menu to select year
Not currently used; may be required in future if tile_density_id is not 1
Validation: ? Removed year shouldn't be before installed date
|
| Crop Intervals | |||
| Crop Interval Basics 2 | |||
harvest_year
crop_intervals[].harvest_year
|
String | PlatformRequired |
Fixed given year for the crop interval; Can add years but cannot edit years.
Prefilled: 2008-2024
Always required
|
crop_id
crop_intervals[].crop_id
|
String | PlatformRequired |
Main crop that was planted for that year.
Prefilled: Derived from CLU
Always required
|
| Management Activities | |||
| All Activity Types 3 | |||
type
crop_intervals[].activities[].type
|
String | PlatformConditional |
Activity type that determines how the values in the inputs object will be interpreted
Prefilled: Various
Required for all activities.
|
date
crop_intervals[].activities[].date
|
String | PlatformConditional |
Activity date for modeling
Prefilled: Various
Required for all activity types except irrigation.
|
inputs
crop_intervals[].activities[].inputs
|
String | PlatformConditional |
JSON object with structure dependent on the activity type.
Prefilled: Various
Required for all activities but structure varies by type.
|
| Planting — Cash Crop 7 | |||
date
crop_intervals[].activities(type:planting_cash).0.date
|
String | PlatformRequired |
Users select the date they planted the cash crop
Prefilled: Historical Average per Crop
Always required
|
planting_operation_id
crop_intervals[].activities(type:planting_cash).0.inputs.planting_operation_id
|
String | PlatformRequired |
These are the twelve options users may select for their planting operation
Prefilled: Typical for Crop
Always required
|
diesel_use gallons diesel per acre
crop_intervals.0.activities(type:planting_cash).0.inputs.diesel_use
|
Object | PlatformOptional |
Estimated fuel consumptions are provided based on industry averages for similar equipment. Users can edit the number
Default: Based on CR-LMOD diesel amounts per operation.
Not required (defaults to CR-LMOD operation amount).
|
bean_variety_id
crop_intervals.0.activities(type:planting_cash).0.inputs.bean_variety_id
|
String | FarmerOptional |
Required for fieldprint interval if crop_id is 10300 (Dry Beans). Not required if crop_id is set to a specific variety already (e.g. 10301-10312).
|
seeding_rate pounds of seed per acre
crop_intervals.0.activities(type:planting_cash).0.inputs.seeding_rate
|
Object | PlatformRequired |
Users input seeding rate by pound per acre, default of 167 is provided for all options
Prefilled: Historical Average per Crop
Always required
|
seed_treatment
crop_intervals.0.activities(type:planting_cash).0.inputs.seed_treatment
|
String | PlatformRequired |
Select yes or no if seed was treated
Prefilled: True
Always required
|
inoculant_applied Legumes
crop_intervals.0.activities(type:planting_cash).0.inputs.inoculant_applied
|
String | PlatformConditional |
Select yes or no if inoculants were applied if legume crop
Prefilled: False
Only required for Alfalfa, Chickpeas (garbanzos), Dry Beans, Dry Peas, Fava Beans, Peanuts, Lentils, Lupin, Soybeans
|
| Planting — Cover Crop 10 | |||
date
crop_intervals[].activities(type:planting_cover).0.date
|
String | PlatformConditional |
Users select date when cover crop was planted
Prefilled: November 15 of prior year
Required if Planting – Cover Crop was selected as an activity.
|
cover_crop_id
crop_intervals[].activities(type:planting_cover).0.inputs.cover_crop_id
|
String | PlatformConditional |
Drop down menu with eight cover crop options
Prefilled: 30770
Required if Planting – Cover Crop was selected as an activity.
|
planting_operation_id
crop_intervals[].activities(type:planting_cover).0.inputs.planting_operation_id
|
String | PlatformConditional |
Options for users to select how cover crop was planted
Prefilled: 22952
Required if Planting – Cover Crop was selected as an activity.
|
diesel_use gallons diesel per acre
crop_intervals.0.activities(type:planting_cover).0.inputs.planting_operation_id
|
Object | PlatformOptional |
Estimates fuel consumptions of field operation based on industry averages for similar equipment are provided. Users can edit this value
Default: Based on CR-LMOD diesel amounts per operation.
Not required (defaults to CR-LMOD operation amount).
|
is_legume
crop_intervals.0.activities(type:planting_cover).0.inputs.is_legume
|
String | PlatformConditional |
Users select what kind of species was dominant, eith legume or non-legume
Default: Depends on cover_crop_id
Required if Planting – Cover Crop was selected as an activity and the selected cover crop has the is_legume property set to "Ask".
|
is_single_species_mix
crop_intervals[].activities(type:planting_cover)[].inputs.is_single_species_mix
|
Boolean | FarmerConditional |
Whether the cover crop seed was a single species or a multiple species mix. Set to true for single species, false for a multi-species mix.
Required if Planting – Cover Crop was selected as an activity.
|
days_established_id
crop_intervals.0.activities(type:planting_cover).0.inputs.days_established_id
|
String | FarmerConditional |
Users select from five options describing the period of the sweason trhat the cover crop was established prior to frost date
Required if Planting – Cover Crop was selected as an activity.
|
growth_id
crop_intervals.0.activities(type:planting_cover).0.inputs.growth_id
|
String | FarmerConditional |
Users select from three options on drop down menu to describe cover crop coverage at full growth: Low (0-30%), Medium (30%-70%) and High (70%-100%)
Required if Planting – Cover Crop was selected as an activity.
|
termination_operation_id
crop_intervals[].activities(type:planting_cover).0.inputs.termination_operation_id
|
String | PlatformConditional |
Users select from one of six options describing how they terminated their cover crop
Prefilled: 23045
Required if Planting – Cover Crop was selected as an activity.
|
termination_date
crop_intervals[].activities(type:planting_cover).0.inputs.termination_date
|
String | PlatformConditional |
Users provide the exact date of cover crop termination through a date selection menu
Prefilled: 5 days before cash crop planting
Required if Planting – Cover Crop was selected as an activity.
|
| Tillage 3 | |||
date
crop_intervals[].activities(type:tillage)[].date
|
String | FarmerConditional |
Users select date when soil was tilled through calendar menu
Prefilled: Various depending on regime
Required if tillage is selected as an activitiy.
|
tillage_operation_id
crop_intervals[].activities(type:tillage)[].inputs.tillage_operation_id
|
String | FarmerConditional |
Users select tillage operation from drop down menu of 25 options. The subsets of options are unique to each tillage operation category available
Prefilled: Various depending on regime
Required if tillage is selected as an activitiy.
Validation: NA
|
diesel_use gallons diesel per acre
crop_intervals.0.activities(type:tillage)[].inputs.diesel_use
|
Object | PlatformOptional |
Estimates fuel consumptions of field operation based on industry averages for similar equipment are provided. Users can edit this value
Default: Based on CR-LMOD diesel amounts per operation.
Not required (defaults to CR-LMOD operation amount).
Validation: NA
|
| Harvest 15 | |||
date
crop_intervals[].activities(type:harvest)[].date
|
String | PlatformRequired |
Provide date that harvest was completed in calendar menu
Prefilled: Historical Average per Crop
Always required
Validation: NA
|
harvest_operation_id
crop_intervals[].activities(type:harvest)[].inputs.harvest_operation_id
|
String | PlatformRequired |
Users select one of 10 options provided in drop down menu describing harvest operation
Prefilled: Typical for Crop
Always required
Validation: NA
|
diesel_use gallons diesel per acre
crop_intervals[].activities(type:harvest)[].inputs.diesel_use
|
Object | PlatformOptional |
Estimates fuel consumptions of field operation based on industry averages for similar equipment are provided. Users can edit this value
Default: Based on CR-LMOD diesel amounts per operation.
Not required (defaults to CR-LMOD operation amount).
Validation: ?
|
yield yield unit
crop_intervals[].activities(type:harvest)[].inputs.yield
|
Object | PlatformRequired |
Yield based on feed size or per planted acre. Users can edit this value
Prefilled: Historical Average per Crop
Always required
Validation: See Validation Values tab
|
alfalfa_avg_harvest_moisture % Alfalfa
crop_intervals[].activities(type:harvest)[].inputs.alfalfa_avg_harvest_moisture
|
Object | PlatformConditional |
Enter the harvest moisture
Prefilled: 0.15
Required if crop is Alfalfa
Validation: Maximium value 75%
|
sugar_content % Sugar Beets
crop_intervals.0.activities(type:harvest).0.inputs.sugar_content
|
Object | PlatformConditional |
Enter the % sugar content of the crop harvested
Prefilled: 0.18
Required if crop is Sugar Beets
Validation: Minimium 9% and Maximium 30%
|
non_irrigated_yield yield unit
crop_intervals.0.activities(type:harvest)[].inputs.non_irrigated_yield
|
Object | FarmerConditional |
Users may estimate what the yield would be without irrigation. May consider using non-irrgated corners of field
Required if irrigated
Validation: See Validation Values tab
|
transport_distance miles
crop_intervals.0.activities(type:harvest)[].inputs.transport_distance
|
Object | PlatformOptional |
Users input distance in miles between field and storage or drying facilities
Default: 0 miles
Not required (defaults to 0 miles)
Validation: NA
|
transport_fuel_id
crop_intervals.0.activities(type:harvest)[].inputs.transport_fuel_id
|
String | PlatformOptional |
After inputting above distances, prompts users with drop down to select fuel type
Default: 1
Not required (defaults to 1)
Validation: NA
|
crop_dried
crop_intervals.0.activities(type:harvest)[].inputs.crop_dried
|
Boolean | FarmerRequired |
Users select no if crop was not dried or dried in open air, select yes if fans or heat was used
Always required (except for Cotton, Corn (silage), Peanuts, Potatoes, and Sugar Beets)
Validation: NA
|
drying_location_id
crop_intervals.0.activities(type:harvest)[].inputs.drying_location_id
|
String | FarmerConditional |
Users select where the crop was dried
Required if crop dried using energy is selected as "yes" (except for Cotton, Corn (silage), Peanuts, Potatoes, and Sugar Beets)
Validation: NA
|
drying_system_id
crop_intervals.0.activities(type:harvest)[].inputs.drying_system_id
|
Object | FarmerConditional |
If On-Farm is selected above, prompts users to select the system used from dropdown menu of seven options
Required if crop dried using energy is selected as "yes" (except for Cotton, Corn (silage), Peanuts, Potatoes, and Sugar Beets)
Validation: NA
|
moisture_removed %
crop_intervals.0.activities(type:harvest)[].inputs.moisture_removed
|
Object | FarmerConditional |
Users enter % of moisture removed through drying, warning is provided that this value typically does not exceed 20 and that it cannot exceed 40
Required if crop dried using energy is selected as "yes" (except for Cotton, Corn (silage), Peanuts, Potatoes, and Sugar Beets)
Validation: 0.4
|
peanut_moisture % Peanuts
crop_intervals.0.activities(type:harvest).0.inputs.peanut_moisture
|
Object | FarmerConditional |
Enter moisture content of peanuts when delivered to the the buying point
Required if crop is Peanuts
Validation: Minimium value 9.3% and Maximium value 31%
|
ginning_moisture_id Cotton
crop_intervals.0.activities(type:harvest).0.inputs.ginning_moisture_id
|
String | FarmerConditional |
Enter moisture of the cotton at ginning
Required if crop is Cotton
Validation: NA
|
| Irrigation 8 | |||
water_source_id
crop_intervals.0.activities(type:irrigation).0.inputs.water_sources[].water_source_id
|
String | PlatformConditional |
Water source options: Deep aquifer groundwater leads to different follow up from the other two options (Alluvial Groundwater and Surface water)
Prefilled: 1
Required if irrigation was added as an activity.
|
application_method_id
crop_intervals[].activities(type:irrigation).0.inputs.water_sources[].application_method_id
|
String | PlatformConditional |
Drop down menu with irrigation methods
Prefilled: 2
Required if irrigation was added as an activity.
|
water_conservation_practice
crop_intervals.0.activities(type:irrigation).0.inputs.water_sources[].water_conservation_practice
|
Boolean | FarmerConditional |
Only available if you select Alluvial Groundwater and Surface Water — allows users to select yes or no if they used water conservation methods
Required if alluvial ground water or surface ground water is selected.
|
irrigation_volume acre_inch / acre
crop_intervals[].activities(type:irrigation).0.inputs.water_sources[].irrigation_volume
|
Object | PlatformConditional |
Available for all water sources, users input a number for the volume of water pumped
Prefilled: Historical Average per Crop
Required if irrigation was selected for an activity.
Validation: 80 ac-in/acre for Alfalfa and Rice crops. 55 ac-in/acre for all other crops.
|
has_irrigation_energy
crop_intervals.0.activities(type:irrigation).0.inputs.water_sources[].has_irrigation_energy
|
Boolean | FarmerConditional |
Allows users to select the irrigation energy source if they had one
Required if irrigation was selected for an activity.
|
pump_pressure psi
crop_intervals.0.activities(type:irrigation).0.inputs.water_sources[].pump_pressure
|
Object | FarmerConditional |
After selecting an energy source, users estimate the PSI values of the pumping system during operation
Required if irrigation was selected for an activity and energy was used to pump the water.
Validation: Commonly 0–130 psi (per FTM Methods)
|
pump_depth ft
crop_intervals.0.activities(type:irrigation).0.inputs.water_sources[].pump_depth
|
Object | FarmerConditional |
After selecting an energy source, users provide the average vertical distance from the pump outlet to the static water level in feet
Required if irrigation was selected for an activity and energy was used to pump the water.
Validation: Commonly 0–1,500 ft (per FTM Methods)
|
energy_source_id
crop_intervals.0.activities(type:irrigation).0.inputs.water_sources[].energy_source_id
|
String | FarmerConditional |
Energy source options for users to select
Required if irrigation was selected for an activity and energy was used to pump the water.
|
| Nutrient — Commercial Fertilizer 11 | |||
date
crop_intervals[].activities(type:nutrient_commercial)[].date
|
String | PlatformConditional |
Users select date when commercial nutrient was applied in calendar menu
Prefilled: Historical Average per Crop
Required if Nutrient Application – Commercial was selected as an activity
|
fertilizer_operation_id
crop_intervals[].activities(type:nutrient_commercial)[].inputs.fertilizer_operation_id
|
String | PlatformConditional |
Users select from dropdown of 10 options describing how fertilzer was applied
Prefilled: 22693
Required if Nutrient Application – Commercial was selected as an activity
|
diesel_use gallons diesel per acre
crop_intervals.0.activities(type:nutrient_commercial)[].inputs.diesel_use
|
Object | PlatformOptional |
Estimates fuel consumptions of field operation based on industry averages for similar equipment are provided. Users can edit this value
Default: Based on CR-LMOD diesel amounts per operation.
Not required (defaults to CR-LMOD operation amount).
|
product_type_id
crop_intervals[].activities(type:nutrient_commercial)[].inputs.fertilizers[].product_type_id
|
String | PlatformConditional |
Users select fertilzer type from drop down menu. These subset options are unique to each fertilzer category (not available if Generic N-P2O5-K2O-S Fertilizer is selected)
Prefilled: 21
Required if Nutrient Application – Commercial was selected as an activity
|
product_amount lbs / ac
crop_intervals[].activities(type:nutrient_commercial)[].inputs.fertilizers[].product_amount
|
Object | FarmerConditional |
Users enter numerical ammount of fertilzer applied per acre. Option is not available if you selected Generic N-P205-K20-S Fertilzers
Required if Nutrient Application – Commercial was selected as an activity and product_type_id is not 21-24
Validation: See validation values tab. Also the sum of all N, P, K applications should not exceed the maxium limits of a single application. 325 lb/ac for N, 150 lb/ac for P, and 300 lb/ac for K
|
slow_release
crop_intervals.0.activities(type:nutrient_commercial)[].inputs.fertilizers[].slow_release
|
Boolean | PlatformOptional |
Checkbox to select slow release fertilzer. Only available when a nitrogen fertilizer is selected.
Default: False
Not required (defaults to false). Only applicable to nitrogen fertiizers.
|
inhibitor
crop_intervals.0.activities(type:nutrient_commercial)[].inputs.fertilizers[].inhibitor
|
Boolean | PlatformOptional |
Checkbox to select nitrification ureease inhibitor. Only available when a nitrogen fertilizer is selected.
Default: False
Not required (defaults to false). Only applicable to nitrogen fertiizers.
|
nitrogen lbs / ac
crop_intervals[].activities(type:nutrient_commercial)[].inputs.fertilizers[].nitrogen
|
Object | PlatformConditional |
This option is available to users who select Generic N-P205-K20-S Fertilzers. Insert pounds per acre of this category
Prefilled: Historical Average per Crop
Required if product_type_id is 21-24
|
phosphorus lbs / ac
crop_intervals[].activities(type:nutrient_commercial)[].inputs.fertilizers[].phosphorus
|
Object | PlatformConditional |
This option is available to users who select Generic N-P205-K20-S Fertilzers. Insert pounds per acre of this category
Prefilled: Historical Average per Crop
Required if product_type_id is 21-24
|
potassium lbs / ac
crop_intervals.0.activities(type:nutrient_commercial)[].inputs.fertilizers[].potassium
|
Object | PlatformConditional |
This option is available to users who select Generic N-P205-K20-S Fertilzers. Insert pounds per acre of this category
Prefilled: Historical Average per Crop
Required if product_type_id is 21-24
|
sulfur lbs / ac
crop_intervals.0.activities(type:nutrient_commercial)[].inputs.fertilizers[].sulfur
|
Object | PlatformConditional |
This option is available to users who select Generic N-P205-K20-S Fertilzers. Insert pounds per acre of this category
Prefilled: Historical Average per Crop
Required if product_type_id is 21-24
|
| Nutrient — Manure 6 | |||
date
crop_intervals[].activities(type:nutrient_manure)[].date
|
String | FarmerConditional |
Users input through calendar menue when manure was applied
Required if Nutrient Application – Manure was selected as an activity
|
application_operation_id
crop_intervals[].activities(type:nutrient_manure)[].inputs.application_operation_id
|
String | FarmerConditional |
Users select from four options from drop down on how manure was applied
Required if Nutrient Application – Manure was selected as an activity
|
diesel_use gallons diesel per acre
crop_intervals.0.activities(type:nutrient_manure)[].inputs.diesel_use
|
Object | PlatformOptional |
Estimates fuel consumptions of field operation based on industry averages for similar equipment are provided. Users can edit this value
Default: Based on CR-LMOD diesel amounts per operation.
Not required (defaults to CR-LMOD operation amount).
|
manure_type_id
crop_intervals[].activities(type:nutrient_manure)[].inputs.manure_type_id
|
String | PlatformOptional |
Manure type is related to percent of solids
Default: 3
Not required (defaults to 3)
|
manure_amount gallons or tons manure per acre
crop_intervals[].activities(type:nutrient_manure)[].inputs.manure_amount
|
Object | FarmerConditional |
Users input rate of application, units of measurement vary based on solid or liquid base manures
Required if Nutrient Application – Manure was selected as an activity
|
animal_source_id
crop_intervals[].activities(type:nutrient_manure)[].inputs.animal_source_id
|
String | FarmerConditional |
Users select source of manure from drop down of 4 options
Required if Nutrient Application – Manure was selected as an activity
|
| Nutrient — Other Organic Amendment 5 | |||
date
crop_intervals[].activities(type:nutrient_other)[].date
|
String | FarmerConditional |
Users provide date amendment was applied in calendar menu
Required if Nutrient Application – Organic Amendement is selected as an activity
Validation: NA
|
application_method_id
crop_intervals[].activities(type:nutrient_other)[].inputs.application_method_id
|
String | FarmerConditional |
Users select how the amendment was applied, there is only one option
Required if Nutrient Application – Organic Amendement is selected as an activity
Validation: NA
|
diesel_use gallons diesel per acre
crop_intervals.0.activities(type:nutrient_other)[].inputs.diesel_use
|
Object | PlatformOptional |
Estimates fuel consumptions of field operation based on industry averages for similar equipment are provided. Users can edit this value
Default: Based on CR-LMOD diesel amounts per operation.
Not required (defaults to CR-LMOD operation amount).
Validation: NA
|
product_id
crop_intervals.0.activities(type:nutrient_other)[].inputs.product_id
|
String | FarmerConditional |
Users select the amendment type used from dropdown of two options
Required if Nutrient Application – Organic Amendement is selected as an activity
Validation: NA
|
product_amount lb/ac
crop_intervals.0.activities(type:nutrient_other)[].inputs.product_amount
|
Object | FarmerConditional |
Users enter numerical ammount applied per acre. Note the unit of measurement
Required if Nutrient Application – Organic Amendement is selected as an activity
Validation: NA
|
| Crop Protectant Spraying 9 | |||
date
crop_intervals[].activities(type:crop_protectant_spraying)[].date
|
String | FarmerConditional |
Provide date that crop protectant or spraying was completed in calendar menu
Required if crop protectant and spray activity added
Validation: NA
|
application_operation_id
crop_intervals[].activities(type:crop_protectant_spraying)[].inputs.application_operation_id
|
String | FarmerConditional |
Users select from three options on what operation best matches with what they conducted
Required if crop protectant and spray activity added
Validation: NA
|
diesel_use gallons diesel per acre
crop_intervals.0.activities(type:crop_protectant_spraying)[].inputs.diesel_use
|
Object | PlatformOptional |
Estimates fuel consumptions of field operation based on industry averages for similar equipment are provided. Users can edit this value
Default: Based on CR-LMOD diesel amounts per operation.
Not required (defaults to CR-LMOD operation amount).
Validation: No
|
herbicides
crop_intervals.0.activities(type:crop_protectant_spraying)[].inputs.herbicides
|
Numeric | FarmerOptional |
Enter numerical value for this type of product used
Default: 0
Not required (defaults to 0)
Validation: NA
|
herbicides_sulfuric
crop_intervals.0.activities(type:crop_protectant_spraying)[].inputs.herbicides_sulfuric
|
Numeric | FarmerOptional |
Enter numerical value for this type of product used
Default: 0
Not required (defaults to 0)
Validation: NA
|
insecticides
crop_intervals.0.activities(type:crop_protectant_spraying)[].inputs.insecticides
|
Numeric | FarmerOptional |
Enter numerical value for this type of product used
Default: 0
Not required (defaults to 0)
Validation: NA
|
fungicides
crop_intervals.0.activities(type:crop_protectant_spraying)[].inputs.fungicides
|
Numeric | FarmerOptional |
Enter numerical value for this type of product used
Default: 0
Not required (defaults to 0)
Validation: NA
|
growth_regulators
crop_intervals.0.activities(type:crop_protectant_spraying)[].inputs.growth_regulators
|
Numeric | FarmerOptional |
Enter numerical value for this type of product used
Default: 0
Not required (defaults to 0)
Validation: NA
|
fumigants
crop_intervals.0.activities(type:crop_protectant_spraying)[].inputs.fumigants
|
Numeric | FarmerOptional |
Enter numerical value for this type of product used
Default: 0
Not required (defaults to 0)
Validation: NA
|
| Residue Management 4 | |||
date
crop_intervals[].activities(type:residue_management)[].date
|
String | FarmerConditional |
Provide date when residue management practices was implemented in calendar menu
Required if residue management is selected as an activity
Validation: NA
|
residue_operation_id
crop_intervals[].activities(type:residue_management)[].inputs.residue_operation_id
|
String | FarmerConditional |
Users select one of 10 options for residue management operations
Required if residue management is selected as an activity
Validation: NA
|
diesel_use gallons diesel per acre
crop_intervals.0.activities(type:residue_management)[].inputs.diesel_use
|
Object | PlatformConditional |
Estimates fuel consumptions of field operation based on industry averages for similar equipment are provided. Users can edit this value
Default: Based on CR-LMOD diesel amounts per operation.
Required if residue management is selected as an activity
Validation: NA
|
fire_acres acres
crop_intervals.0.activities(type:residue_management)[].inputs.fire_acres
|
Object | PlatformOptional |
If burning is selected as the residue management operation, users select amount of acres set on fire to second decimal point place
Default: Plantable acres
Not required (defaults to plantable acres)
Validation: Not more than plantable acres
|
| Additional Data | |||
| Nutrient Management Practices 6 | |||
management_plan
crop_intervals.0.additional_data.nutrient_management.management_plan
|
Boolean | FarmerRequired |
Asks if a nutrient management plan was followed, option to select Yes or No
Always Required
|
management_4r_ids
crop_intervals.0.additional_data.nutrient_management.management_4r_ids[]
|
Array | PlatformOptional |
Asks if the 4R's of nutrient stewardship were followed, allows to select multiple options
Default: ["1","2","3","4"] if management_plan=true; [] if management_plan=false
Not required (defaults to ["1","2","3","4"] if management_plan=true; [] if management_plan=false)
|
nutrient_rate_practice_ids
crop_intervals.0.additional_data.nutrient_management.nutrient_rate_practice_ids[]
|
Array | FarmerOptional |
Asks if the nutrient rate was adjusted based on four selectable options (can select multiple)
Default: []
Not required (defaults to [])
|
nutrient_setbacks
crop_intervals.0.additional_data.nutrient_management.nutrient_setbacks
|
Boolean | FarmerRequired |
Whether nutrients setbacks were followed, select yes or no
Always Required
|
precision_application
crop_intervals.0.additional_data.nutrient_management.precision_application
|
Boolean | FarmerRequired |
Asks if nutrients were applied with precision concepts, yes or no
Always Required
|
p_multi_crop_application_id
crop_intervals.0.additional_data.nutrient_management.p_multi_crop_application_id
|
String | FarmerConditional |
Select from the drop down how many years phosphorus was intended to supply the crop
Required. Set to 0 if no phosphorus was applied.
|
| Soil Test 2 | |||
p_soil_test_level_id
crop_intervals.0.additional_data.soil_test.p_soil_test_level_id
|
String | PlatformOptional |
Allows users to select phospherus levels from soil test
Default: 5
Not required (defaults to 5).
|
p_drawdown_strategy_ids
crop_intervals.0.additional_data.soil_test.p_drawdown_strategy_ids[]
|
Array | FarmerOptional |
Displays if Excessive/Very High is selected. Check box to select options for drawdown strategies.
Default: []
Not required (defaults to []); only applicable if p_soil_test_level_id selection is 'Excessive/Very High'
|
| Pest Management 1 | |||
integrated_pest_management_id
crop_intervals.0.additional_data.pest_management.integrated_pest_management_id
|
String | FarmerRequired |
These are the pest management options, can only select one
Always Required
|
| Habitat & Wildlife 1 | |||
wildlife_habitat_ids
crop_intervals.0.additional_data.habitat.wildlife_habitat_ids[]
|
Array | FarmerOptional |
These are the seasonal enhancement options, can select multiple
Default: []
Not required (defaults to [])
|
| Rice Water Regime 2 | |||
water_regime_id Rice
crop_intervals.0.additional_data.rice_water_regime.water_regime_id
|
String | FarmerConditional |
Users select if the field was nonflooded during the preseason or flooded
Required if crop is Rice
|
water_management_id Rice
crop_intervals.0.additional_data.rice_water_regime.water_management_id
|
String | FarmerConditional |
Users select the water management strategies they sed from three options, different types of flooding
Required if crop is Rice
|
Yield Validation Limits by Crop
The API validates yield values against crop-specific limits. Values exceeding the “Flag” threshold trigger a warning; values exceeding the “Hard Limit” are rejected.
| Crop | Units | Minimum | Flag Max | Hard Limit Max |
|---|---|---|---|---|
| ALFALFA | TONS / ACRE | 0.1 | 10 | 20 |
| BARLEY | BU / ACRE | 15 | 150 | 300 |
| CORN | BU / ACRE | 10 | 325 | 500 |
| CORN SILAGE | TONS / ACRE | 2 | 35 | 50 |
| COTTON | LB / ACRE | 90 | 2200 | 5000 |
| PEANUTS | LB / ACRE | 250 | 7000 | 10000 |
| POTATOES | CWT / ACRE | 50 | 800 | 1600 |
| RICE | CWT / ACRE | 20 | 100 | 200 |
| SORGHUM | BU / ACRE | 20 | 175 | 300 |
| SOYBEANS | BU / ACRE | 10 | 90 | 180 |
| SUGARBEETS | TONS / ACRE | 10 | 50 | 100 |
| WHEAT | BU / ACRE | 10 | 140 | 300 |
Irrigation Volume Limits
| Crop Category | Maximum (acre-inches) |
|---|---|
| Alfalfa and Rice | 80 |
| All Other Crops | 55 |
This artifact is only available to current Field to Market Qualified Data Management Partners.
This spreadsheet provides a listing of inputs required for the Fieldprint API. It also provides guidance for migration of data from Version 4 to Version 5. We suggest developers use this spreadsheet in combination with other documentation sources and API request and response examples. Note that the spreadsheet will be updated from time to time. If you need access, find errors or have questions, please contact Field to Market staff at support@fieldtomarket.org.
a