---
title: Monitor API V3 technical migration guide
description: Use this guide to learn how to migrate from Monitor API V2 (current version) to V3 (new version).
---

[Skip to content](https://help.regrow.ag/monitor-api-v3-technical-migration-guide#main-content)

English

Show submenu for translations

[Customer portal](https://help.regrow.ag/support?hsLang=en)

![Regrow\_logo-1.png\]](https://help.regrow.ag/hs-fs/hubfs/03.%20Logos/Regrow_logo-1.png?height=40&name=Regrow_logo-1.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Customer portal](https://help.regrow.ag/support)
- [Go to regrow.ag](https://www.regrow.ag/)

[Go to regrow.ag](https://www.regrow.ag/)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge Base](https://help.regrow.ag/?hsLang=en)
2. [Monitor API](https://help.regrow.ag/monitor-api?hsLang=en)
3. [Integrate with Monitor API](https://help.regrow.ag/monitor-api?hsLang=en#integrate-with-monitor-api)

# Monitor API V3 technical migration guide

## Use this guide to learn how to migrate from Monitor API V2 (current version) to V3 (new version).

 

We’re planning a new major version of Monitor API (v3), that comes with improved practice reporting and new features in the API. This release includes breaking changes to the API schema, that will require customers to update their integration in order to take advantage of the new features and continue using the API.

Use this guide for high level guidance on what's new and how to upgrade an existing integration. For more detailed integration information check out the full [Integration Guide](https://help.regrow.ag/guide-how-to-integrate-with-monitor-api?hsLang=en) or the [technical API reference](https://developers.regrow.ag/docs/monitor-v2/1/overview).

#### What You'll Learn

After reading this guide, you'll understand the following:

- New features and model improvements released in V3 of Monitor API
- How to upgrade an integration with Monitor API V2 → V3
- How to interpret changes to practice data

#### What's New in V3

**Improved CropID ML Model for predicting crop type and growing season**.

This release upgrades the **CropID ML model** (CropID V4), enhancing crop type prediction and introducing new functionality to **predict planting and harvest dates** using machine learning. These improvements provide more precise crop identification while enabling better tracking of field activity timelines.

**Key Updates in the API:**

- **Improved crop type classification** for greater accuracy.
- **New planting and harvest date predictions**, offering improved insights into field operations.
- Additional **crop types** are supported in select regions. *(CropID now supports `lentils`, `chickpeas`, `flax`, `peanuts` and `durum wheat` in CONUS and Canada)*

*CropID V4 will be released for CONUS and Canada in the Monitor V3 release. Refreshed data using CropID V4 in Europe will be coming soon!*

 

**Improved cover crop detection algorithm**.

The this release includes an update to the cover crop detection algorithms to improve clarity, flexibility, and accuracy in vegetation coverage assessment. This version introduces **simplified, monthly field-scale vegetation metrics** based on NDVI, making it easier to track cover crop presence and vigor over time & apply insights to key use cases such as practice verification.

**Key Updates in the API:**

- **Simplified cover crop object** for easier integration and more applicable use-case focused insights.
- **Cover crop determinations no longer reported on perennial fields** for more precise monitoring.
- **Improved validation datasets** enhance accuracy and reliability.

These changes provide a more interpretable & applicable method for tracking cover crop practice adoption, enabling better insights for tailored application.

 

**Improved tillage classifications between three tillage classes:** no till**,** reduced till**,** conventional till

With this release, we have improved the accuracy of tillage classification by refining residue percentage thresholds based on crop type. Previously, **Monitor** applied static USDA residue thresholds across all crops to distinguish between conventional, reduced-till, and no-till practices. While effective for high-biomass crops like corn, these thresholds proved less reliable for **fragile** crops—those with lower or rapidly degrading residue, such as cotton and soybeans.

The residue thresholds for fragile crops have been adjusted to improve the differentiation between reduced-till and no-till practices. This update reduces conservative bias and enhances alignment with observed tillage practices, particularly for crops with lower or rapidly degrading biomass that would change the expected residue persistence over time.

This release includes the update to the residue thresholds for fragile vs. non-fragile crops:

**Note**: Tillage thresholds are based on the crop that produced the residue, which is the crop in the previous cultivation cycle. For example, if a field grows corn one year and soybeans the next year, the residue & tillage practice for the soybean cycle will be based on the residue produced from the prior corn crop. 

|   | **Fragile crops** | **Non-fragile crops** |
| --- | --- | --- |
| *Common crops in this category* | Soybeans, winter wheat, cotton, cereal grains, potatoes, canola | Corn, rice, sorghum, sugarcane, hay/alfalfa |
| **Conventional Till** | 0-15% residue | 0-30% residue |
| **Reduced till** | 15-30% residue | 30-60% residue |
| **No Till** | 30% + residue | 60% + residue |

 

 

**New error codes added to make missing data scenarios more transparent and actionable. **  
This release includes three new error codes that provide more details and information about how to use and action different scenarios where remote sensing data may not be available. Codes \`MD07\`, \`MD08\` and \`MD09\` codes can now be returned from the API. Check out the [Monitor Error Reporting Guide](https://help.regrow.ag/monitor-error-reporting?hsLang=en) for additional details.

 

Migrating to V3 data schema

None of the existing Monitor API endpoints will change from V2 → V3, so no updates to the integration workflow are needed.

The field results schema is changing with the introduction of a new data points within the green cover object. This change requires an integration update to continue using the API.

**Affected API Action(s):**

| **API action** | **Endpoint** | **Description** |
| --- | --- | --- |
| Retrieve field practice data | [/jobs/{job\_id}/results](https://developers.regrow.ag/docs/monitor-v2/1/routes/jobs/%7Bjob_id%7D/results/get) (GET) | Use the jobID from the response of the execution post to retrieve the field events for the time period specified. |

 

**Cover crop data**

Some of the legacy data points in the green cover object in V2 will be replaced with improved data points in Monitor V3. 

| **Legacy** green cover **data point** | **New** cover crop **data point** | **Description** |
| --- | --- | --- |
| `start_date` | `start_date` *no change* | The first day of the cover crop observation window (the time period over which a field is observed for cover crop activity). |
| `end_date` | `end_date` *no change* | The last day of the cover crop observation window (the time period over which a field is observed for cover crop activity). |
| `cultivation_cycle_id` | `cultivation_cycle_id` *no change* | The unique identifier of the cultivation cycle the cover crop practice belongs to. |
| `green_cover_class` | `cover_crop_class` | The cover\_crop\_class is the practice determination over the observation period. Cover crop class options include: - "Cover crop" - "Cover crop not tracked" - "Potential cover crop" - "Cover crop not applicable" - *Note: this is a new cover crop class that will be applied when a perennial crop is detected on the field* - "No green cover data" |
| `emergence_quality` | `emergence_class` | emergence\_class is a classification of how a crop emerged in the first three months of the cover crop observation period. Emergence can be used to understand if a cover crop may have been planted, and if it established strongly. Possible options include: - "No vegetation" - "Weak emergence" - "Good emergence" - "Strong emergence" |
| `emergence_quality_confidence` | `emergence_class_confidence` | A confidence metric associated with the emergence\_class. Confidence is reported as a scale between 1-3, where values correspond to low, medium and high confidence. Emergence confidence is an indicator of the amount of high-quality, interpretable remote sensing data available over the observation period. |
| `living_root quality_score` | `ndvi_mean` | The NDVI mean is the average monthly NDVI over the cover crop observation period. It can be used to evaluate the average greenness of the crop, providing an indication of crop strength and vigor over the growing period. ndvi\_mean is reported on a scale of 0-100. |
| `overall_ confidence` | `cover_crop_class_confidence` | cover\_crop\_class\_confidence is an indicator of confidence in the cover crop classification. Confidence is reported as a scale between 1-3, where values correspond to low, medium and high confidence. Cover crop class confidence is an indicator of the amount of high-quality, interpretable remote sensing data available over the observation period. |
| `living_root_score` | *Not applicable* *deprecated in V3* |   |
| `valid_observation_percent` | *Not applicable* *deprecated in V3* |   |
| `healthy_vegetation_coverage_percent` | *Not applicable* *deprecated in V3* |   |
| `vegetation_vigor` | *Not applicable* *deprecated in V3* |   |

 

**Example of the new green cover object:**

![](https://help.regrow.ag/hs-fs/hubfs/Screenshot%202025-05-08%20at%206-48-24%E2%80%AFAM-png.png?width=511&height=249&name=Screenshot%202025-05-08%20at%206-48-24%E2%80%AFAM-png.png)

 

**Tillage data**

The tillage object schema within field results is not changing. There are **no breaking changes** to API structure for tillage —only improved classification logic.

*What this means for using Monitor tillage determinations:*

- **Improved classification accuracy** for fragile crops, reducing misidentification of tillage practices.
- **Potential shifts in classification outputs** for specific crop types, leading to more reliable downstream insights.

To ensure seamless migration, review any tillage-dependent workflows or models that may be impacted by updated classifications.

- [Sustainability Insights](https://help.regrow.ag/sustainability-insights?hsLang=en#main-content)

    - [General](https://help.regrow.ag/sustainability-insights?hsLang=en#general)
    - [Configure](https://help.regrow.ag/sustainability-insights?hsLang=en#configure)
    - [Report](https://help.regrow.ag/sustainability-insights?hsLang=en#report)
    - [Plan](https://help.regrow.ag/sustainability-insights?hsLang=en#plan)
    - [Data updates](https://help.regrow.ag/sustainability-insights?hsLang=en#data-updates)
    - [Models](https://help.regrow.ag/sustainability-insights?hsLang=en#models)
    - [Integrations](https://help.regrow.ag/sustainability-insights?hsLang=en#integrations)
- [MRV](https://help.regrow.ag/mrv?hsLang=en#main-content)

    - [Login and registration](https://help.regrow.ag/mrv?hsLang=en#login-and-registration)
    - [Field boundaries](https://help.regrow.ag/mrv?hsLang=en#field-boundaries)
    - [Data entry tips and guidelines](https://help.regrow.ag/mrv?hsLang=en#data-entry-tips-and-guidelines)
    - [Data entry accelerators](https://help.regrow.ag/mrv?hsLang=en#data-entry-accelerators)
    - [Soil sampling](https://help.regrow.ag/mrv?hsLang=en#soil-sampling)
    - [Program data review](https://help.regrow.ag/mrv?hsLang=en#program-data-review)
    - [Reporting](https://help.regrow.ag/mrv?hsLang=en#reporting)
- [Research and data credits](https://help.regrow.ag/research-and-data-credits?hsLang=en)
- [Measure API: Enteric](https://help.regrow.ag/measure-api-enteric?hsLang=en#main-content)

    - [Getting started](https://help.regrow.ag/measure-api-enteric?hsLang=en#getting-started)
- [Measure API: Intervention](https://help.regrow.ag/measure-api-intervention?hsLang=en#main-content)

    - [Introduction](https://help.regrow.ag/measure-api-intervention?hsLang=en#introduction)
    - [Getting started](https://help.regrow.ag/measure-api-intervention?hsLang=en#getting-started)
    - [Common Questions](https://help.regrow.ag/measure-api-intervention?hsLang=en#common-questions)
    - [Outcomes](https://help.regrow.ag/measure-api-intervention?hsLang=en#outcomes)
    - [Product Releases](https://help.regrow.ag/measure-api-intervention?hsLang=en#product-releases)
- [Measure API: Inventory](https://help.regrow.ag/measure-api-inventory?hsLang=en#main-content)

    - [Introduction](https://help.regrow.ag/measure-api-inventory?hsLang=en#introduction)
    - [Getting started](https://help.regrow.ag/measure-api-inventory?hsLang=en#getting-started)
    - [Outcomes](https://help.regrow.ag/measure-api-inventory?hsLang=en#outcomes)
- [Monitor API](https://help.regrow.ag/monitor-api?hsLang=en#main-content)

    - [Getting started](https://help.regrow.ag/monitor-api?hsLang=en#getting-started)
    - [Remote sensing technology](https://help.regrow.ag/monitor-api?hsLang=en#remote-sensing-technology)
    - [Integrate with Monitor API](https://help.regrow.ag/monitor-api?hsLang=en#integrate-with-monitor-api)
    - [Understanding Monitor field data](https://help.regrow.ag/monitor-api?hsLang=en#understanding-monitor-field-data)
- [Cradle to farm-gate emission factors](https://help.regrow.ag/cradle-to-farm-gate-emission-factors?hsLang=en#main-content)

    - [Getting started](https://help.regrow.ag/cradle-to-farm-gate-emission-factors?hsLang=en#getting-started)
    - [Methodology](https://help.regrow.ag/cradle-to-farm-gate-emission-factors?hsLang=en#methodology)
    - [On-field activity data sources](https://help.regrow.ag/cradle-to-farm-gate-emission-factors?hsLang=en#on-field-activity-data-sources)

[![Chill listening crop-3](https://help.regrow.ag/hs-fs/hubfs/03.%20Logos/Regrow_logo.png?width=96&height=24&name=Regrow_logo.png "Chill listening crop-3")](https://www.regrow.ag/)

Copyright © 2026, Regrow Agriculture Inc.