Fieldprint API – /v5/FieldData/PrefillCropIntervals

The PrefillCropIntervals endpoint generates complete, production-ready crop intervals 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 /v5/FieldData/PrefillFieldHistory endpoint (which generates all years from 2008 to present based primarily on USDA Cropland Data Layer data), the single interval prefill gives you control over key production characteristics for each year you specify.

Endpoint Details

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

Request Body

The request body is a JSON object containing a field object with the field boundary geometry and an array of one or more crop_intervals, each specifying the crop and year along with optional management parameters.

Field Object

Crop Intervals Array

Each object in the crop_intervals array represents a single crop year with the following fields:

Tillage Class Options

Example Request

POST https://api.fieldtomarket.org/v5/FieldData/PrefillCropIntervals
Content-Type: application/json
Authorization: Bearer {your_api_key}

{
  "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": { "value": 125, "unit": "ton / acre" },
      "tillage_class_id": "6",
      "total_n": { "value": 200.0, "unit": "lb / acre" }
    }
  ]
}

Example Response

The response returns the enriched field data (with calculated size, state, and county) and complete crop intervals with all generated management activities.

{
  "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"
          }
        },
        // Tillage — 3 passes generated for Conventional Till (tillage_class_id "6")
        {
          "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" }
      }
    }
  ]
}

Response Structure

Field Object (Response)

Crop Intervals (Response)

Each crop interval in the response includes the harvest_year, crop_id, and resolved tillage_class_id, along with a complete activities array and additional_data.

Activity Types

The activities array contains generated management activities. Each activity has a type, date, and inputs object. The following activity types may be generated depending on the input parameters:

Validation & Error Handling

The API validates all input fields and returns structured error responses. Common validation error types include:

Example: Invalid Crop ID

{
  "crop_intervals": {
    "0": {
      "crop_id": [
        {
          "message": "\"99999\" is not a valid choice in ReferenceData/Crops",
          "code": "CHOICE"
        }
      ]
    }
  }
}

Example: Missing Geometry

{
  "field": {
    "geometry": [
      {
        "message": "Missing geometry",
        "code": "GEOMETRY"
      }
    ]
  }
}

Example: Invalid Units for Yield

{
  "crop_intervals": {
    "0": {
      "yield": [
        {
          "message": "Units are [UNITS], but should be one of: [volume]/ac, [weight]/ac",
          "code": "UNITS"
        }
      ]
    }
  }
}

Usage Notes

Related Endpoints

Reach out to support@fieldtomarket.org with additional questions on implementation.