Fieldprint API – Single Crop Interval Prefill
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.
Overview
The Fieldprint API’s Prefill Single Crop Interval endpoint allows API partners to generate a complete crop interval (single crop year) with default management activities based on customizable input parameters. This endpoint is ideal when you need detailed field data for one or more specific years rather than a complete multi-year history.
Unlike the full field history prefill endpoint, which generates all years from 2008 to present based primarily on USDA Crop Data Layer data, the single interval prefill gives you control over key production characteristics for each year you specify.
Use Cases
Use this endpoint when you need to:
- Build multi-year histories with different characteristics for each year
- Generate complete management activities for specific crop years where you have partial production data
- Create scenarios with known crop types, yields, or management practices
- Prefill data for years where farmers have provided some information but not complete field records
Required Fields
Field Geometry: Provide the field boundary as a GeoJSON Polygon with coordinates in decimal degrees (longitude, latitude).
Crop Intervals: An array of one or more crop intervals, each requiring:
crop_id– The Fieldprint crop identifierharvest_year– The year the crop was harvested
Optional Parameters
For each crop interval, you can specify:
is_irrigated(boolean) – Whether the crop was irrigatedcover_crop(boolean) – Whether a cover crop was usedyield– Crop yield with value and unit (e.g., “ton / acre”, “bu / acre”)tillage_class_id– The tillage intensity classificationtotal_n– Total nitrogen applied with value and unit (e.g., “lb / acre”)
What the Endpoint Returns
The endpoint returns a complete, production-ready crop interval with:
Enriched Field Data
- Calculated field size (in acres)
- State and county location information derived from the geometry
Complete Crop Interval Activities
For each interval specified, the endpoint generates default activities based on your input parameters and regional agronomic norms:
- Planting operations – Including seeding rates, diesel use, and seed treatment assumptions
- Cover crop management – Planting and termination operations (if
cover_cropis true) - Irrigation events – Water sources, volumes, and application methods (if
is_irrigatedis true) - Harvest operations – Using your specified yield or regional defaults
- Tillage operations – Multiple passes based on the
tillage_class_id - Nutrient applications – Fertilizer types and amounts based on
total_nand crop nutrient requirements - Additional data – Soil test levels and crop-specific parameters
All activities include operation dates, diesel use estimates, and appropriate default values for required fields.
Example Request and Response
Below is an example of /v5/FieldData/PrefillCropIntervals request.
{
"field": {
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-95.53909487338437,
42.92811105124366
],
[
-95.53909487338437,
42.92643775409019
],
[
-95.53795761676207,
42.92643775409019
],
[
-95.53795761676207,
42.92811105124366
],
[
-95.53909487338437,
42.92811105124366
]
]
]
}
},
"crop_intervals": [
{
"crop_id": "10401",
"harvest_year": 2023,
"is_irrigated": true,
"cover_crop": true,
"yield": {"unit": "ton / acre","value": 125},
"tillage_class_id": "6",
"total_n": {
"value": 200.0,
"unit": "lb / acre"
}
}
]
}Below is the resulting response:
{
"field": {
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-95.53909487,
42.92811105
],
[
-95.53909487,
42.92643775
],
[
-95.53795762,
42.92643775
],
[
-95.53795762,
42.92811105
],
[
-95.53909487,
42.92811105
]
]
]
},
"size": {
"value": 4.2667242,
"unit": "acre"
},
"state": "IA",
"county": "O'Brien County"
},
"crop_intervals": [
{
"harvest_year": 2023,
"crop_id": "10401",
"tillage_class_id": "6",
"activities": [
{
"type": "planting_cash",
"date": "2023-05-06",
"inputs": {
"planting_operation_id": "22917",
"seeding_rate": {
"value": 30.0,
"unit": "lb / acre"
},
"diesel_use": {
"value": 0.64,
"unit": "gal_diesel / acre"
},
"seed_treatment": true,
"inoculant_applied": false
}
},
{
"type": "planting_cover",
"date": "2022-11-15",
"inputs": {
"cover_crop_id": "30770",
"planting_operation_id": "22952",
"diesel_use": {
"value": 0.1283,
"unit": "gal_diesel / acre"
},
"termination_date": "2023-05-01",
"termination_operation_id": "23045"
}
},
{
"type": "irrigation",
"date": "2023-10-04",
"inputs": {
"water_sources": [
{
"water_source_id": "1",
"irrigation_volume": {
"value": 12.0,
"unit": "acre_inch / acre"
},
"application_method_id": "2"
}
]
}
},
{
"type": "harvest",
"date": "2023-10-09",
"inputs": {
"harvest_operation_id": "22819",
"yield": {
"value": 125.0,
"unit": "ton / acre"
},
"diesel_use": {
"value": 1.53,
"unit": "gal_diesel / acre"
},
"transport_fuel_id": "1"
}
},
{
"type": "tillage",
"date": "2023-04-06",
"inputs": {
"tillage_operation_id": "23050",
"diesel_use": {
"value": 1.5,
"unit": "gal_diesel / acre"
}
}
},
{
"type": "tillage",
"date": "2023-04-21",
"inputs": {
"tillage_operation_id": "22970",
"diesel_use": {
"value": 0.38,
"unit": "gal_diesel / acre"
}
}
},
{
"type": "tillage",
"date": "2023-04-29",
"inputs": {
"tillage_operation_id": "22988",
"diesel_use": {
"value": 0.62,
"unit": "gal_diesel / acre"
}
}
},
{
"type": "nutrient_commercial",
"date": "2023-05-09",
"inputs": {
"fertilizer_operation_id": "22693",
"diesel_use": {
"value": 0.16,
"unit": "gal_diesel / acre"
},
"fertilizers": [
{
"product_type_id": 21,
"nitrogen": {
"value": 200.0,
"unit": "lb / acre"
},
"phosphorus": {
"value": 133.0,
"unit": "lb / acre"
},
"potassium": {
"value": 84.0,
"unit": "lb / acre"
},
"sulfur": {
"value": 16.0,
"unit": "lb / acre"
},
"slow_release": false,
"inhibitor": false
}
]
}
}
],
"additional_data": {
"soil_test": {
"p_soil_test_level_id": "5"
},
"rice_water_regime": {
"water_regime_id": "1"
}
}
}
]
}